Go项目中，复合词文件名应采用全小写、单词间用下划线分隔的snake_case风格（如weighted_union_find.go），这是标准库与主流开源项目的事实惯例，兼顾可读性、跨平台兼容性及工具链稳定性。
go语言文件命名规范：复合词应统一使用小写+下划线（snake_case）风格（如weighted_union_find.go），这是标准库与主流开源项目的事实惯例，兼顾可读性、跨平台兼容性及工具链稳定性。
在Go语言工程实践中，文件名不是风格偏好问题，而是影响构建可靠性、IDE智能补全、CI/CD稳定性和团队协作效率的关键约定。针对复合词（如“Weighted Union Find”）的文件命名，权威实践明确指向一种统一方案：
✅ 推荐：weighted_union_find.go（snake_case）
- ✅ 符合Go标准库惯例：runtime/internal/atomic/atomic_test.go、net/http/internal/chunked_test.go、encoding/json/encode.go 等大量核心代码均采用小写+下划线；
- ✅ 全平台安全：下划线在Windows、Linux、macOS文件系统中100%兼容，无大小写敏感导致的导入失败风险；
- ✅ 语义清晰且易扫描：相比weightedunionfind.go（易误读为weightedunionfind单个词）或weightedUnionFind.go（违反Go文件命名潜规则），下划线明确分隔语义单元，便于快速识别算法模块边界。
❌ 不推荐方案：
- weightedUnionFind.go：驼峰式命名是Go中变量、函数、结构体的规范，绝不用于文件名。IDE可能误判为非Go源文件，go build虽能编译但破坏一致性，且部分构建工具（如Bazel、gazelle）会报错；
- weightedunionfind.go：虽技术上可行，但可读性差，难以区分weightedunion与find的逻辑归属，违背“见名知意”原则，在大型项目中显著降低代码导航效率。
? 配套规范需同步遵守：
立即学习“go语言免费学习笔记（深入）”；
- 该文件内包声明必须与目录名严格一致（如位于algo/目录下，则首行必须为 package algo）；
- 导出函数/类型须用大驼峰（如 func NewWeightedUnionFind() *UnionFind），私有函数用小驼峰（如 func (u *UnionFind) unionRoots()）；
- 若该算法需跨项目复用，建议将其独立为专用包（如 github.com/yourname/algo/weightedunionfind），包名仍为全小写 weightedunionfind（无下划线！），体现Go“包名即标识符”的本质约束。
? 进阶提示：当某类功能复杂度上升时，可升级为模块化目录结构，而非堆砌长文件名：
algo/ ├── weighted_union_find/ # 目录名仍全小写，无下划线（因包名限制） │ ├── union_find.go # 包名: weightedunionfind │ ├── path_compression.go │ └── weighted_union_find_test.go
此时目录名 weighted_union_find 是合法的（仅作路径标识），但其内所有.go文件的package声明必须是 package weightedunionfind —— 这也印证了为何文件名本身用weighted_union_find.go更直观：它精准映射人类认知中的模块名称，而包名则遵循工具链刚性要求。
遵循这一规范，你的weighted_union_find.go不仅可通过go test无缝运行，还能在VS Code中实现精准跳转、自动导入，并在CI环境中零故障构建——这才是真正“Go味十足”的工程实践。
