小白学go基础04-命名惯例对标识符进行命名

计算机科学中只有两件难事:缓存失效和命名。

命名是编程语言的要求,但是好的命名却是为了提高程序的可读性和可维护性。好的命名是什么样子的呢?Go语言的贡献者和布道师Dave Cheney给出了一个说法:"一个好笑话,如果你必须解释它,那就不好笑了。好的命名也类似。"无论哪门编程语言,良好的命名都应该遵循一些通用的原则,但就像之前提到的"语言影响思维"的假说那样,不同的编程语言会有一些个性化的命名惯例。

在gofmt的帮助下,Go语言统一了代码风格标准,Gopher再也无须为括号摆放位置、使用制表符还是空格、是否对齐赋值操作等而争论了。在这种情况下,命名成了广大Gopher为数不多可以"自由发挥"的空间。不过关于命名,Go语言也有自己期望大家共同遵循的原则。

下面将详细阐述这两个原则以及在这两个原则下的一些命名惯例。

简单且一致

对于简单,我们最直观的理解就是"短小",但这里的简单还包含着清晰明确这一前提。

下面是Go语言中一些常见类别标识符的命名惯例。

1. 包

对于Go中的包(package),一般建议以小写形式的单个单词命名。Go标准库在这方面给我们做出了很好的示范

我们在给包命名时不要有是否与其他包重名的顾虑,因为在Go中,包名可以不唯一。

比如:foo项目有名为log的包,bar项目也可以有自己的名为log的包。

示例如下。

cpp 复制代码
import "github.com/bigwhite/foo/log" // log.XX中的log指代github.com/ bigwhite/foo/log下的包
import barlog "github.com/bigwhite/bar/log" // barlog这个显式包名指代git

Go语言建议,包名应尽量与包导入路径(import path)的最后一个路径分段保持一致。

比如:包导入路径golang.org/x/text/encoding的最后路径分段是encoding,该路径下包名就应该为encoding。

但在实际情况中,包名与导入路径最后分段不同的也有很多。

比如:实时分布式消息队列NSQ的官方客户端包的导入路径为github.com/nsqio/go-nsq,但是该路径下面的包名却是nsq。笔者分析这主要是为了用仓库名称强调该实现是针对Go语言的,比如go-nsq的意义是这是一份Go语言实现的NSQ客户端API库,为的是与nsq-java、pynsq、rust-nsq等其他语言的客户端API进行显式区分。

此外,我们在给包命名的时候,不仅要考虑包自身的名字,还要兼顾该包导出的标识符(如变量、常量、类型、函数等)的命名。

2. 变量、类型、函数和方法

一个Go工程中包的数量是有限的,变量、类型、函数和方法的命名占据了命名工作的较大比重。

Go语言官方要求标识符命名采用驼峰命名法(CamelCase),以变量名为例,如果变量名由一个以上的词组合构成,那么这些词之间紧密相连,不使用任何连接符(如下划线)。

驼峰命名法有两种形式:

1)一种是第一个词的首字母小写,后面每个词的首字母大写,叫作"小骆峰拼写法"(lowerCamelCase),这也是在Go中最常见的标识符命名法;

2)而 第 一 个 词 的 首 字 母 以 及 后 面 每 个 词 的 首 字 母 都 大 写, 叫 作"大 驼 峰 拼 写法"(UpperCamelCase),又称"帕斯卡拼写法"(PascalCase)。

3)由于首字母大写的标识符在Go语言中被视作包导出标识符,因此只有在涉及包导出的情况下才会用到大驼峰拼写法。不过如果缩略词的首字母是大写的,那么其他字母也要保持全部大写,比如HTTP(Hypertext Transfer Protocol)、CBC(Cipher Block Chaining)等

为变量、类型、函数和方法命名时依然要以简单、短小为首要原则。

感受一下Go命名惯例带来的效果:

cpp 复制代码
// 不好的命名
func RuneCount(buffer []byte) int {
runeCount := 0
for index := 0; index < len(buffer); {
if buffer[index] < RuneSelf {
index++
} else {
_, size := DecodeRune(buffer[index:])
index += size
}
runeCount++
}
return runeCount
}
cpp 复制代码
// 好的命名
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
}

Go语言命名惯例深受C语言的影响,这与Go语言之父有着深厚的C语言背景不无关系。

相关推荐
掉头发的王富贵13 分钟前
我来入职新公司两个月了,为什么只写了100行代码?
后端·ai编程
从零开始的代码生活_29 分钟前
C++ 内存管理:从内存分区到 new/delete 底层原理
开发语言·c++·后端
315356691339 分钟前
Superpowers:GPT-5.6 时代下的流程毒瘤
前端·后端
wabs66640 分钟前
关于单调栈【力扣739.每日温度的思考】
java·开发语言
AOwhisky1 小时前
Python 学习笔记(第三期)——流程控制核心知识点自测与详解
开发语言·笔记·python·学习·云原生·运维开发·流程控制
逆向编程2 小时前
Socket异常连接自动清理方案
开发语言
神奇小汤圆2 小时前
2026 Java岗面试题库(已收录GitHub),覆盖所有考点
后端
ArixBit2 小时前
用 Go 手撸 Agent 框架 #4:工具定义与契约——让 Agent 学会调用多工具
后端
枕星而眠3 小时前
【数据结构】红黑树入门指南
运维·数据结构·c++·后端
神奇小汤圆3 小时前
JDK 8 → 17 → 21 → 25:一次性讲清四代版本的关键跃迁
后端