gocloc是统计go项目各package行数最稳的工具，能自动识别go.mod、按package划分、跳过vendor和测试文件；安装运行命令为go install github.com/helm/chartmuseum/cmd/gocloc@latest和gocloc --by-file --include-ext=go ./...。
用 gocloc 快速统计 Go 项目各 package 行数
直接上结论：别手写脚本解析 go list 输出，gocloc 是目前最稳、最贴 Go 工程结构的命令行工具。它能自动识别 go.mod 管理的 module，按 package 划分目录，跳过 vendor 和测试文件（*_test.go），结果可读性强。
常见错误是用 cloc（通用多语言工具）硬扫整个目录——它把 internal、cmd、api 全当普通子目录，不理解 Go 的 package 边界，导致同一 package 被拆到多个条目里，总数对但分布错。
- 安装：
go install github.com/helm/chartmuseum/cmd/gocloc@latest（注意不是原版cloc） - 运行：
gocloc --by-file --include-ext=go ./...，--by-file是关键，否则默认只出汇总 - 输出中每行第一列是 package 路径（如
github.com/xxx/core/auth），第二列才是代码行数
为什么不用 go list -f + wc -l 手动拼？
因为 Go 的 package 不等于目录：一个目录下可以有多个 .go 文件属于不同 package（比如 main 和 testutil 混放），也可以有 build tags 控制文件是否参与编译。手动统计会漏掉条件编译文件，或把 ignored.go（带 //go:build ignore）算进去。
-
go list -f '{{.GoFiles}}' ./...只返回被当前构建环境认可的源文件列表，但不包含行数 - 如果再对每个文件
wc -l，就得自己 parsego list的 JSON 输出，还要按PkgPath分组求和——容易在嵌套 module 或 replace 语句下出错 - 更麻烦的是：
go list默认不扫描vendor/外部依赖，但你可能想排除它们；而gocloc默认就跳过vendor和GOPATH下的非 module 代码
gocloc 的几个关键参数影响统计精度
默认行为适合大多数场景，但三个参数必须根据需求确认：
立即学习“go语言免费学习笔记（深入）”；
-
--exclude-dir=vendor,third_party：显式加更保险，尤其当项目用了go mod vendor且想彻底排除依赖代码 -
--include-ext=go,gox：如果用了.gox这类自定义后缀（如某些代码生成器产出），得手动加，否则忽略 -
--skip-uniqueness-check：当项目含大量 symlink（比如 CI 中挂载的缓存路径），不加这个会报错退出
注意：不要用 --by-dirent，它按目录统计，不是按 Go package；也不要开 --xml 或 --json 输出——人眼难读，且 package 名在字段里埋得深（比如 language 字段值是 Go，不是 package 名）。
CI 中集成时容易被忽略的路径问题
在 GitHub Actions 或 GitLab CI 里跑 gocloc，最容易踩的坑是工作目录没切对，或者 go.mod 不在根目录：
- 如果项目是 mono-repo，主
go.mod在backend/go.mod，那必须先cd backend再执行gocloc ./...，否则它会从 repo 根开始扫，找不到 valid module - 如果用
docker run方式，镜像里没go环境没关系，但必须把go.mod和所有.go文件都bind mount进去，且挂载点路径要和本地一致，否则gocloc解析import路径会失败 - 某些私有 registry 的 replace 路径（如
replace example.com/lib => ../lib）会导致gocloc尝试读取相对路径下的文件——若该路径不在挂载范围内，就静默跳过，不会报错，但统计变少
package 边界和模块路径解析，是 Go 生态里最不透明的一环，工具链稍有偏差，数字就不可信。宁可多跑一次 go list -m all 确认 module 结构，也别信默认路径。
