Go中变量命名规则与实例
作者:Spongecaptain 发布时间:2024-05-09 09:55:45
前言
来自 Google 的 Andrew Gerrand 曾经关于 Go 中的参数命名规范进行了分享,slides 为 https://talks.golang.org/2014/names.slide
命名习惯很重要
良好的可读性是高质量代码的要求之一
良好的命名习惯有助于提高代码可读性
良好命名喜欢的特质
Good Name 将具有如下的特质:
Consistent (easy to guess),
Short (easy to type),
Accurate (easy to understand)
经验法则
变量申明与变量使用之间越远,那么变量名字应当越长。
这也解释了,为什么 for 循环次数变量使用 i 作为遍历用的临时变量,而不是语义上更具体的 index 作为变量名。
大小写混用的变量名
我们不应该使用 names_with_underscores 作为变量名,而是 namesWithUnderscores 作为变量名。
另一方面,首字母缩略词,应当是大写,例如 ServeHTTP 以及 IDProcessor。
这被称为 MixedCase,类似于驼峰原则命名,但是专业词汇的首字母缩写均应当写成大写形式。
变量名避免冗余
变量名不是越长越好,常变量名会模糊代码功能。
常见的常量、类型组合可能使用非常简短的名字:
使用 i 而不是 index
使用 r 而不是 reader
使用 b 而不是 buffer
根据上下文,避免使用冗余的名称:
在 RuneCount 方法内部,使用 count 而不是 reuneCount
在 map 语句中,使用 ok 而不是 keyInMap:
v, ok := m[k]
常变量名也许在长函数、有很多变量的函数中有帮助,但是这通常也意味着你应该重构代码。
Bad codes vs good codes
// Bad
func RuneCount(buffer []byte) int {
// runeCount -> count
runeCount := 0
// index -> i , buffer -> b
for index := 0; index < len(buffer); {
if buffer[index] < RuneSelf {
index++
} else {
// size -> n
_, size := DecodeRune(buffer[index:])
index += size
}
runeCount++
}
return runeCount
}
// Good
func RuneCount(b []byte) int {
count := 0
for i := 0; i < len(b); {
if b[i] < RuneSelf {
i++
} else {
_, n := DecodeRune(b[i:])
i += n
}
count++
}
return count
}
函数参数的命名
函数参数与变量名一样,都起到了文档的作用。
1.当函数参数的类型具有描述性时,那么函数参数名就可以简短一些:
func AfterFunc(d Duration, f func()) *Timer
func Escape(w io.Writer, s []byte)
2.当函数参数的类型语义不清,那么参数名应当更具体详细一些:
func Unix(sec, nsec int64) Time
???????func HasPrefix(s, prefix []byte) bool
返回值的命名
导出函数(exported function)返回值应当仅仅出于编写文档目的进行命名。
下面是返回值命名的好例子:
// Good
func Copy(dst Writer, src Reader) (written int64, err error)
// Good
func ScanBytes(data []byte, atEOF bool) (advance int, token []byte, err error)
方法 Receiver 的命名
Go 中结构体可以拥有方法,在为结构体声明方法时,结构体被称为 receiver。
按照惯例,方法接收者的命名通常为 1 个字符或者 2 个字符,因为结构体的每一个方法都将使用同一个 receiver 名称。
// Good
func (b *Buffer) Read(p []byte) (n int, err error)
// Good
func (sh serverHandler) ServeHTTP(rw ResponseWriter, req *Request)
// Good
func (r Rectangle) Size() Point
Receiver 的名称一定要确保一致性,如果结构体的 method1 使用 r 作为 receiver 名称,那么 method2 就不应当使用 rdr 作为名称。
导出 package 级别变量命名
package 级别的变量已经被 package name 限定了,因此需要注意导出变量、常量、函数、类型名的冗余问题。
例如:
我们使用 bytes.Buffer 而不是 bytes.ByteBuffer
我们使用 strings.Reader 而不是 strings.StringReader
导出变量名不要与 package 之间存在冗余。
接口类型
只有一个方法的接口,接口名通常简单在方法后面加上 er 来进行命令,例如:
type Reader interface {
Read(p []byte) (n int, err error)
}
有时候,上述策略会导致接口名语法不正确,但是我们仍然可以选择这么做,例如:
type Execer interface {
Exec(query string, args []Value) (Result, error)
}
也有时候,我们会修改接口名,使得其符合英语语法:
type ByteReader interface {
ReadByte() (c byte, err error)
}
当一个接口包含多个方法时,应当选择一个准确描述其用途的名称,例如 net.Conn,http.ResponseWriter,io.ReadWriter。
error 命名
错误类型与错误变量应当有不同的命名格式:
// 错误类型 Error types
type ExitError struct {
...
}
// 错误变量 Error values
var ErrFormat = errors.New("image: unknown format")
Packages 名
选择对导出的名称具有意义的包名称。
避免使用 util、common 等包名。
结论
使用短变量名
变量取名考虑上下文,避免冗余,例如函数内的局部变量考虑函数名,包导出变量考虑包名
来源:https://spongecaptain.cool/post/go/names/
猜你喜欢
- 如下所示:screen.widthscreen.heightscreen.availHeight //获取去除状态栏后的屏幕高度screen
- 关于 TensorFlowTensorFlow™ 是一个采用数据流图(data flow graphs),用于数值计算的开源软件库。节点(N
- 引言TypeScript 给 JavaScript 添加了一套类型系统,可以在编译期间检查出类型错误,这增加了代码的健壮性,但也多了一个编译
- 矩阵相乘需要前面矩阵的行数与后面矩阵的列数相同方可相乘。第一步,先将前面矩阵的每一行分别与后面矩阵的列相乘,作为结果矩阵的行列;第二步算出结
- 函数:endswith()作用:判断字符串是否以指定字符或子字符串结尾,常用于判断文件类型相关函数:判断字符串开头 startswith()
- 业务场景:关联不同数据库中的表的查询比如说,要关联的表是:机器A上的数据库A中的表A && 机器B上的数据库B中的表B。这种
- 除了B-Tree 索引,MySQL还提供了如下索引:Hash索引只有Memory引擎支持,场景简单R-Tree索引MyISAM的一个特殊索引
- 大家先看一下Python os模块中的部分函数python 路径相关的函数 os.listdir(dirname):列出dirname下的目
- 国外纷纷传言IE8将是Internet Explorer的最后一个版本,这个猜测来源于Microsoft的CEO Steve
- 一、设置SQLServer身份验证1、按下windows+R,弹出运行框。2、在弹出框中输入cmd,按下enter键。3、在dos命令窗口输
- 2.彻底弄懂CSS盒子模式二(导航栏实例) 3.彻底弄懂CSS盒子模式三(浮动的表演和清除的自述) 4.彻底弄懂CSS盒子模式四(绝对定位和
- 本项目是利用五年左右的世界地震数据,通过python的pandas库、matplotlib库、basemap库等进行数据可视化,绘制出地震散
- 前言春节快到了,一年一度的支付宝集五福活动就要来了,阿牛也是突发奇想,看能不能用python的turtle库画个"福"字
- php ffmpeg获取视频缩略图1.环境centos 7ffmpeg version 2.8.15 Copyright2.centos7安
- #!/usr/bin/env python2#-*- coding:utf-8 -*-__author__ = 'jalright&
- 前言由于数据库的类型为Data 类型,所以插入数据库的时候我先把前端传入的string类型的时间转为Time 再插入。Go 提供了两种插入的
- 长话短说,看这个 form 元素:<form method="post" action=&qu
- 我就废话不多说了,直接上代码了。非常简单哦!pytorch转成longtensorb = torch.rand(3,3)#得到的是float
- 代码如下:create table A_TEST ( PAYOUT_ITEM_CODE VARCHAR2(30) not null, FOR
- 具体代码如下所示:#字符串反转def reverse (s): rt = '' for i in r