golang struct扩展函数参数命名警告

时间:2022-05-11 19:10:02

今天在使用VSCode编写golang代码时,定义一个struct,扩展几个方法,如下:

package storage

import (
"fmt" "github.com/zsy619/gcommon"
) //ChunkFooter 块Footer
type ChunkFooter struct {
ChunkDataTotalSize int
} //NewChunkFooter 创建一个ChunkFooter
func NewChunkFooter(chunkDataTotalSize int) *ChunkFooter {
var result = new(ChunkFooter)
result.ChunkDataTotalSize = chunkDataTotalSize
return result
} //ToString ChunkFooter转换为String
func (cf *ChunkFooter) ToString() string {
return fmt.Sprintf("[ChunkDataTotalSize:%d]", cf.ChunkDataTotalSize)
} //AsByteArray 转换成byte数组
func (nf *ChunkFooter) AsByteArray() []byte {
//var result [chunkFooterSize]byte
buffer := gcommon.IntToFixedLengthBytes(nf.ChunkDataTotalSize, ChunkFooterSize)
return buffer
}

请注意函数ToString与AsByteArray中的*ChunkFooter参数,一个是cf,一个nf,提示以下警告:

golang struct扩展函数参数命名警告

意思是将nf更改为cf,也就是struct扩展函数中对应对象的命名应该已第一个函数的命名为基准。

可参考参官方指南Effective GolangGolang Code Review Comments进行整理,力图与官方及社区编码风格保持一致。

将函数ToString修改成如下:

//ToString ChunkFooter转换为String
func (this *ChunkFooter) ToString() string {
return fmt.Sprintf("[ChunkDataTotalSize:%d]", this.ChunkDataTotalSize)
}

提示以下警告信息:

golang struct扩展函数参数命名警告

要排除使用me、this、self这些命名。可根据golang官网的命名规则,并结合本公司要求,进行统一命名。