Go 函数命名规范：导出与非导出标识符的大小写规则-Golang-PHP中文网

Go 函数命名规范：导出与非导出标识符的大小写规则

go 中函数名首字母大小写决定其是否可被外部包访问——大写字母开头表示导出（public），小写则为包内私有，这是语言级语法要求，而非风格偏好。

go 中函数名首字母大小写决定其是否可被外部包访问——大写字母开头表示导出（public），小写则为包内私有，这是语言级语法要求，而非风格偏好。

在 Go 语言中，函数（以及变量、类型、常量等标识符）的命名并非自由选择的风格问题，而是直接影响程序可见性与封装性的语法机制。Go 通过首字母大小写来明确区分“导出”（exported）与“非导出”（unexported）标识符：

✅ 导出标识符：首字母为大写（如 WriteToMongoDB、GetUser、HTTPClient），可在定义包之外被其他包导入并使用；
❌ 非导出标识符：首字母为小写（如 writeToMongoDB、getUser、httpClient），仅限于当前包内访问，天然实现封装。

因此，WriteToMongoDB 和 writeToMongoDB 的差异不是执行效率或运行时行为的区别，而是编译期可见性规则的体现。若你希望该函数作为公共 API 提供给其他模块调用（例如在 pkg/db 包中供 main 或 handler 包使用），必须命名为 WriteToMongoDB；若仅为内部辅助逻辑（如重试封装、日志预处理），则应使用 writeToMongoDB。

命名风格统一性要求

Go 官方风格指南（Effective Go）明确推荐：所有标识符均采用驼峰式（CamelCase），且缩略词保持全大写。这意味着：

光子AI

一款AI视频创作工具，主要用于AI电商服饰商拍平台，适合需要提升相关任务效率的用户。

下载

✅ 推荐：WriteToDB、HTTPServer、XMLParser、IDGenerator
❌ 避免：writeToDb（小写 db 破坏缩略词一致性）、WriteToDb（混合大小写）、write_to_mongo（下划线，Go 不采用）

示例代码：

// 导出的公共函数（可供其他包调用）
func WriteToMongoDB(doc interface{}) error { /* ... */ }

// 非导出的内部辅助函数（仅本包可用）
func writeToMongoDBWithRetry(doc interface{}, maxRetries int) error { /* ... */ }

// 常量命名同样遵循此规则
const (
    DefaultTimeout = 30 * time.Second
    MaxRetries     = 3

    internalBufferSize = 4096 // 小写开头 → 包内私有
)