Go语言文件命名规范：复合词应统一使用小写+下划线（snake

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语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

该文件内包声明必须与目录名严格一致（如位于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味十足”的工程实践。