社区默认规范。 若某公司技能明确覆盖 samber/cc-skills-golang@golang-naming 技能，则该技能优先生效。

Go 命名规范

Go 偏好简短、易读的名称。首字母大小写控制可见性：大写表示导出（exported），小写表示未导出（unexported）。所有标识符 必须 使用 MixedCaps 风格，禁止 使用下划线。

“清晰优于巧妙。” — Go 谚语

“设计架构，命名组件，记录细节。” — Go 谚语

如需忽略某条规则，只需在代码中添加注释即可。

速查表

MixedCaps

所有 Go 标识符 必须 使用 MixedCaps（或 mixedCaps）。禁止 在标识符中使用下划线 —— 唯一例外是测试函数子用例（如 TestFoo_InvalidInput）、自动生成代码，以及 OS/cgo 互操作场景。这不是风格偏好，而是核心机制：Go 的导出机制依赖大小写，且整个工具链均假设标识符采用 MixedCaps 风格。

// ✓ 正确
MaxPacketSize
userCount
parseHTTPResponse

// ✗ 错误 —— 这些风格与 Go 的导出机制及工具链预期冲突
MAX_PACKET_SIZE   // C/Python 风格
max_packet_size   // snake_case
kMaxBufferSize    // 匈牙利命名法

避免重复（Stuttering）

Go 的调用点始终包含包名，因此在标识符中重复包名会浪费读者精力 —— 例如 http.HTTPClient 强迫读者两次解析 “HTTP”。标识符 不得 重复已在包名、类型名或上下文中明确的信息。

// 正确 —— 调用点简洁清晰
http.Client       // 非 http.HTTPClient
json.Decoder      // 非 json.JSONDecoder
user.New()        // 非 user.NewUser()
config.Parse()    // 非 config.ParseConfig()

// 在 sqldb 包中：
type Connection struct{}  // 非 DBConnection —— “db” 已在包名中体现

// “避免重复”适用于所有导出类型，不仅限于主结构体：
// 在 dbpool 包中：
type Pool struct{}        // 非 DBPool
type Status struct{}      // 非 PoolStatus —— 调用方写作 dbpool.Status
type Option func(*Pool)   // 非 PoolOption

常被忽略的规范

以下规范虽正确但不够直观，是最常见的命名错误来源：

构造函数命名： 当一个包仅导出一个主要类型时，构造函数应命名为 New()，而非 NewTypeName()。此举可避免重复 —— 调用方写作 apiclient.New()，而非 apiclient.NewClient()。仅当包中存在多个可构造类型时（如 http.NewRequest、http.NewServeMux），才使用 NewTypeName()。

布尔结构体字段： 未导出的布尔字段 必须 使用 is/has/can 前缀 —— 如 isConnected、hasPermission，而非裸露的 connected 或 permission。导出的 getter 方法保留该前缀：IsConnected() bool。这使字段读起来像一个问题，并能自然区分布尔类型与其他类型。

错误字符串全小写（含缩略词）： 应写作 "invalid message id"，而非 "invalid message ID"，因为错误字符串常与其他上下文拼接（如 fmt.Errorf("parsing token: %w", err)），句中混用大小写显得不协调。哨兵错误（sentinel error）应以包名为前缀：errors.New("apiclient: not found")。

枚举零值： 总是在 iota 索引 0 处显式定义 Unknown/Invalid 哨兵值。声明 var s Status 会静默初始化为 0；若该值映射到真实状态（如 StatusReady），则代码可能误以为状态已被主动选择，而实际只是未初始化。

子测试名称： t.Run() 中表格驱动测试用例的名称应为全小写的描述性短语："valid id"、"empty input" —— 而非 "valid ID" 或 "Valid Input"。

详细分类

完整规则、示例及设计原理，请参阅：

• 包、文件与导入别名（Packages, Files & Import Aliasing） —— 包命名（单字、小写、无复数）、文件命名规范、导入别名模式（仅在冲突时使用以降低认知负荷）、目录结构。

• 变量、布尔值、接收者与缩略词（Variables, Booleans, Receivers & Acronyms） —— 基于作用域的命名（长度匹配作用域：3 行循环用 i，包级变量用更长名称）、单字母接收者惯例（s 表示 Server）、缩略词大小写（URL 非 Url，HTTPServer 非 HttpServer）、布尔命名模式（isReady、hasPrefix）。

• 函数、方法与选项（Functions, Methods & Options） —— Getter/Setter 模式（Go 省略 Get，故 user.Name() 在调用点自然可读）、构造函数规范（New 或 NewTypeName）、具名返回值（仅用于文档说明）、格式化函数后缀（Errorf、Wrapf）、函数式选项（WithPort、WithLogger）。

• 类型、常量与错误（Types, Constants & Errors） —— 接口命名（Reader、Closer 等带 -er 后缀）、结构体命名（名词，MixedCaps）、常量（MixedCaps，非 ALL_CAPS）、枚举（类型名前缀，如 StatusReady）、哨兵错误（ErrNotFound 变量）、错误类型（PathError 后缀）、错误消息规范（全小写，无标点）。

• 测试命名（Test Naming） —— 测试函数命名（TestFunctionName）、表格驱动测试字段规范（input、expected）、测试辅助函数命名、子用例命名模式。

常见错误

通过 Linter 强制执行

许多命名规范问题可由 Linter 自动检测，例如：revive、predeclared、misspell、errname。配置与使用方法详见 samber/cc-skills-golang@golang-linter 技能。

交叉引用

• → 查看 samber/cc-skills-golang@golang-code-style 技能，了解更广泛的格式与风格决策
• → 查看 samber/cc-skills-golang@golang-structs-interfaces 技能，深入理解接口命名与接收者设计
• → 查看 samber/cc-skills-golang@golang-linter 技能，了解自动化强制执行方案（revive、predeclared、misspell、errname）