Go 命名规范指南

你在命名上卡在哪

Go 里可见性靠首字母大小写、标识符一律 MixedCaps，这和 Java/C 的 snake_case、全大写常量习惯冲突。调用点总会带上包名，若再写出 http.HTTPClient 或 user.NewUser()，读者要在同一屏里重复解析同一段信息。错误文案、布尔字段、iota 枚举的零值若命名随意，还会在 fmt.Errorf 拼接、未初始化结构体等场景里悄悄埋坑。

技能如何组织内容

本技能把命名当成可执行的约定表，而不是风格偏好：

• 速查表：包、文件、导出/未导出标识符、接口 -er、接收者缩写、Err/Error、构造器 New vs NewTypeName、WithContext/In/Must 等变体，一行对照示例。
• MixedCaps 与防 stutter：说明为何下划线与工具链、导出机制冲突；强调标识符不要重复包名或类型名里已有的信息。
• 常被漏掉的细节：单主类型用 New()；未导出布尔字段用 is/has/can；错误字符串全小写（含缩写）；枚举零位放 Unknown；子测试名用小写短语。
• 误区对照表：从 ALL_CAPS 常量、GetName()、缩写大小写混用，到 util 包名、接收者名不一致等，逐项给出改法。
• 与 linter 衔接：指向 revive、errname 等可自动拦截的问题，并交叉引用更广的 code style、interface、lint 技能。

需要忽略某条规则时，技能也说明可在代码旁用注释标明例外（含测试子用例、生成代码、cgo 等边界）。

适用边界

内容聚焦命名与标识符语义，不覆盖依赖注入、架构分层或完整 formatting 规范（后者见 golang-code-style）。社区默认说明：若组织内有显式覆盖 golang-naming 的公司技能，以公司技能为准。