Go语言包名必须全小写、无下划线、无驼峰，且应简短语义明确；因工具链不支持非ASCII或下划线开头，驼峰虽语法通过但违反社区约定并导致补全与文档异常。
Go语言包名必须全小写、无下划线、无驼峰，且应简短、语义明确——这是强制规范，不是风格建议。
为什么不能用下划线或驼峰
Go 工具链（如 go build、go test）和导入路径解析器不支持非 ASCII 字母或下划线开头的包名；更关键的是，Go 官方明确禁止在包声明中使用 import "my_package" 这类含下划线的标识符——编译会直接报错 syntax error: unexpected _。驼峰（如 jsonParser）虽能通过语法检查，但违反 Go 社区约定，且与标准库（net/http、strings）风格冲突，导致 IDE 补全异常、文档生成失败。
如何选一个“好”的包名
包名不是功能描述句，而是该包导出符号的自然前缀。判断标准很简单：看调用时是否顺口。
- ✅ 好名字：
http（http.Get）、sql（sql.Open）、jwt（jwt.Parse）——短、唯一、调用时不冗余 - ❌ 坏名字：
databaseutils（太长）、user_service（含下划线）、UserRepo（驼峰）、myprojectauth（带项目名，无法复用） - 包名不必唯一全局，但应在你自己的模块内唯一；不同模块可有同名包（如多个服务都有
handler包），只要导入路径不同即可
常见场景下的命名选择
实际开发中容易纠结的几类情况：
立即学习“go语言免费学习笔记（深入）”；
- HTTP 路由处理逻辑 → 用
handler，不是httphandler或api；标准库已用http，你不需要重复 - 数据库操作封装 → 用
store或repo，避免db（太泛，易与database/sql混淆）或postgresstore（绑定实现） - 工具函数集合 → 用
util是常见妥协，但更推荐按领域切分，如strutil、timeutil；若只有 2–3 个函数，优先考虑合并进主包而非单独建util - 内部私有包（不被其他模块 import）→ 仍需遵守小写规则，可用
internal目录隔离，但包名本身还是cache、retry这类词，不是internal_cache
导入路径 vs 包名的区别
这是最常被混淆的一点：导入路径（如 github.com/you/app/pkg/auth）可以含下划线、大小写、多级目录，但包声明里 package auth 的 auth 必须是合法标识符。即使路径很长，包名也只取最后一段，且必须小写化。例如：
import "github.com/you/lib/v2/encoding/json"
对应源文件里只能写 package json，不能写 package json_v2 或 package JSON。
真正难的不是规则本身，而是克制住想“说得更清楚”的冲动——包名越短，调用越轻量；而“说清楚”的责任，应该由文档、变量名和函数签名承担，不是包名。
