go 中函数（及所有标识符）的首字母大小写直接决定其是否可被外部包访问——大写开头表示导出（public），小写开头表示未导出（private），这是语言语法要求，而非风格偏好。
go 中函数（及所有标识符）的首字母大小写直接决定其是否可被外部包访问——大写开头表示导出（public），小写开头表示未导出（private），这是语言语法要求，而非风格偏好。
在 Go 语言中，函数命名并非自由选择风格的问题，而是严格受语言规范约束的语法机制。核心规则只有一条：首字母大小写决定标识符的可见性（exportedness）。
- ✅ WriteToMongoDB —— 首字母 W 大写 → 导出标识符 → 可被其他包导入并调用；
- ❌ writeToMongoDB —— 首字母 w 小写 → 未导出标识符 → 仅限当前包内使用。
这与 Java、C# 等语言中通过 public/private 关键字控制可见性的设计截然不同。Go 将可见性编码进名称本身，使开发者在任意代码位置（如调用处）无需跳转至定义即可直观判断该函数能否跨包使用，显著提升代码可读性与维护性。
正确的命名实践
Go 官方风格指南（Effective Go）明确要求：
- 所有标识符统一采用 驼峰式（CamelCase），即单词连写、内部首字母大写；
- 唯一例外是首字母：导出时必须大写，非导出时必须小写；
- 缩写词保持全大写，避免混合大小写（如 DB, ID, HTTP, XML）。
✅ 推荐写法（符合规范）：
func WriteToMongoDB(doc interface{}) error { ... } // 导出函数，首字母大写 + 缩写全大写
func writeToMongoDB(doc interface{}) error { ... } // 包内私有函数，首字母小写
func GetHTTPResponse(url string) ([]byte, error) { ... }
const MaxRetries = 3
var defaultDBTimeout = 5 * time.Second
❌ 应避免的写法：
func writeToMongoDB() {} // ✅ 合法但非导出 → 若需对外提供，应改为 WriteToMongoDB
func WriteToMongodb() {} // ❌ 缩写 "MongoDB" 拆分错误（应为 MongoDB，非 Mongodb）
func writeDb() {} // ❌ 缩写 "DB" 应全大写 → 正确为 writeDB 或 writeToDB
func WriteDB() {} // ✅ 简洁且符合缩写规范（比 WriteToDB 更常用）
特殊场景：国际化与 Unicode 标识符
Go 支持 UTF-8 编码的 Unicode 标识符（如 日本語, αβγ），但部分语言无大小写概念。此时无法通过首字母大小写表达导出意图，社区约定使用前缀 X 显式标记导出标识符，例如：
var X日本語 = "Hello" // 表示该变量可被其他包访问
func XValidate() bool { ... }
该约定见于 Go FAQ，属边缘但合规的实践，日常开发中仍应优先使用标准 ASCII 驼峰命名。
总结
- ? 大小写 = 可见性：不是风格，是语法铁律；
- ? 统一驼峰，缩写全大写：WriteToDB, HTTPClient, XMLParser；
- ? 禁用下划线命名（如 write_to_mongo）——Go 不采用 snake_case；
- ? 导出函数名应简洁、语义清晰，避免过度冗长（如 WriteDocumentToMongoDBCollectionWithRetry → 可简化为 WriteToDB + 文档说明）。
遵循此规范，不仅让代码兼容 Go 工具链（如 go doc, golint），更是践行 Go “少即是多”哲学的关键一步。
