Go语言中模块名应全小写、用连字符分隔、与仓库路径一致，包名应简短小写、单数、与目录同名，避免模糊命名，必要时使用导入别名以提升可读性。
Go语言的包与模块命名直接影响代码的可读性、可维护性和可分享性。合理的命名能让团队协作更顺畅，也能让开源项目更容易被他人使用。以下是Go中包与模块命名的规范与最佳实践。
模块命名规范
模块名通常对应你的项目在版本控制系统（如GitHub）中的路径，它应当清晰表达项目的用途，并遵循以下规则：
- 使用全小写字母：避免使用大写或驼峰命名，确保在所有系统中都能正确解析。
- 使用连字符分隔单词：例如 github.com/yourname/go-utils 比 github.com/yourname/goutils 更易读。
- 避免使用下划线：Go官方建议使用连字符而非下划线，保持一致性。
- 语义明确：模块名应准确反映功能，比如 cli-tool 或 http-client-wrapper。
当你运行 go mod init 时，传入的模块名最好与仓库地址一致，便于依赖管理。
包命名规范
包名是导入后使用的标识符，应简洁、一致且能反映其职责。
立即学习“go语言免费学习笔记（深入）”；
- 简短且小写：包名应为单个简短的小写词，如 log、http、utils。
- 与目录名一致：包名应与其所在目录名相同，避免混淆。
- 避免使用复数：如用 route 而非 routes，保持简洁统一。
- 不使用下划线或驼峰：Go社区普遍采用单个小写词，增强一致性。
- 避免通用命名冲突：不要命名为 common、misc 这类模糊名称，应体现具体功能域。
例如，一个处理用户认证的包可以命名为 auth，放在 auth/ 目录下，导入后使用 auth.Login()，直观清晰。
导入别名的使用场景
当包名与本地变量或已有包冲突时，可使用导入别名：
- 解决命名冲突：如两个包都叫 client，可通过 import api "xxx/client" 区分。
- 提升可读性：对于较长或含义不清的包，别名能让调用更清晰，例如测试中常用 import require "github.com/stretchr/testify/require"。
- 避免滥用：除非必要，不要随意使用别名，否则会增加理解成本。
最佳实践总结
- 模块名使用全小写 + 连字符，与仓库路径一致。
- 包名使用简短小写单数名词，与目录名一致。
- 避免模糊命名，如 util、common，应按功能划分。
- 保持命名一致性，团队内应统一规范。
- 合理使用导入别名，仅在必要时提高可读性。
基本上就这些。命名看似小事，但长期项目中影响深远。遵守社区惯例，能让你的Go代码更“地道”。
