当前位置：首页 > news >正文

Golang之路---04 项目管理——编码规范

news 2025/8/1 17:50:52

本文根据个人编码习惯以及网络上的一些文章，整理了一些大家能用上的编码规范，可能是一些主流方案，但不代表官方。

1. 文件命名

由于 Windows平台文件名不区分大小写，所以文件名应一律使用小写
不同单词之间用下划线分词，不要使用驼峰式命名
如果是测试文件，可以以 _test.go 结尾
文件若具有平台特性，应以文件名_平台.go 命名，比如 utils_ windows.go，utils_linux.go，可用的平台有：windows, unix, posix, plan9, darwin, bsd, linux, freebsd, nacl, netbsd, openbsd, solaris, dragonfly, bsd, notbsd， android，stubs
一般情况下应用的主入口应为 main.go，或者以应用的全小写形式命名。比如MyBlog 的入口可以为 myblog.go

2. 常量命名
目前在网络上可以看到主要有两种风格的写法

第一种是驼峰命名法，比如 appVersion
第二种使用全大写且用下划线分词，比如 APP_VERSION

这两种风格，没有孰好孰弱，可自由选取，我个人更倾向于使用第二种，主要是能一眼与变量区分开来。

如果要定义多个变量，请使用括号来组织。

const (APP_VERSION = "0.1.0"CONF_PATH = "/etc/xx.conf"
)

自构建的枚举类型应该从 1 开始，除非从 0 开始是有意义的
eg:

// Bad
type Operation intconst (Add Operation = iotaSubtractMultiply
)// Good
type Operation intconst (Add Operation = iota + 1SubtractMultiply
)

3. 变量命名
和常量不同，变量的命名，开发者们的喜好就比较一致了，统一使用驼峰命名法

在相对简单的环境（对象数量少、针对性强）中，可以将完整单词简写为单个字母，例如：user写为u
若该变量为 bool 类型，则名称应以 Has, Is, Can 或 Allow 开头。例如：isExist ，hasConflict 。
其他一般情况下首单词全小写，其后各单词首字母大写。例如：numShips 和 startDate 。
若变量中有特有名词（以下列出），且变量为私有，则首单词还是使用全小写，如 apiClient。
若变量中有特有名词（以下列出），但变量不是私有，那首单词就要变成全大写。例如：APIClient，URLString
函数内使用短变量声明（海象运算符 :=）。函数外使用长变量声明（var 关键字），var 关键字一般用于包级别变量声明，或者函数内的零值情况。
如果有可能，尽量缩小变量的作用范围。
eg:

// Bad
err := ioutil.WriteFile(name, data, 0644)
if err != nil {return err
}
// Good
if err := ioutil.WriteFile(name, data, 0644); err != nil {return err
}