go test -cover 默认仅统计当前包，跨包调用不自动纳入；需用 go test ./... -coverprofile=coverage.out -covermode=count 递归测试并生成可合并覆盖率数据。
go test -cover 默认只统计当前包，跨包调用不会自动纳入覆盖率——这是最常被误以为“不准”的根源。
为什么 go test -cover 显示的覆盖率看起来偏低？
默认情况下，go test 只分析当前目录下被测试文件直接 import 的源码文件，不递归扫描子目录或外部依赖包。如果你的 main.go 调用了 ./pkg/utils 里的函数，但没在当前目录运行针对 ./pkg/utils 的测试，那部分代码压根不会出现在覆盖率统计里。
- 覆盖率统计范围 = 当前
go test命令作用的包路径（即当前目录对应的包） - 子包（如
./internal/handler）必须显式指定才能参与统计：go test ./... -cover -
-cover不等价于 “整个项目”，它没有全局视角，只是按包聚合
怎么真正测出整个项目的覆盖率？
用 ./... 通配符递归运行所有子包测试，并用 -coverprofile 输出可合并的覆盖率数据：
go test ./... -coverprofile=coverage.out -covermode=count
关键点：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
-covermode=count记录每行执行次数（比默认的set更准，能识别“只走一次分支”的伪覆盖） -
coverage.out是文本格式，可用go tool cover解析 - 注意：如果某个子包没有测试文件（
*_test.go），go test ./...会跳过它，也不会报错——覆盖率自然漏掉
如何查看带高亮的 HTML 覆盖率报告？
生成并打开可视化报告只需两步：
go tool cover -html=coverage.out -o coverage.html
然后用浏览器打开 coverage.html。注意事项：
- 红色行 = 完全未执行；绿色 = 执行过；灰色 = 不可测（如
func main()、空行、注释） - 如果某函数显示为灰色而非红色，大概率是它根本没被任何测试调用，也没被其他被测函数间接调用
-
go tool cover -func=coverage.out可输出函数级覆盖率列表，适合快速定位低覆盖函数
常见坑：覆盖率数字对不上，或者跑出 panic
几个高频翻车点：
- 混用
-covermode=count和-covermode=atomic：后者用于并发测试，前者是单测默认，二者 profile 文件不兼容 - 在 CI 中直接跑
go test ./...却忽略子模块的go.mod：某些子包可能因版本不一致导致测试失败，覆盖率中断 - 忘记清理旧的
coverage.out：多次go test -coverprofile会覆盖写入，不是追加——想合并多个包结果，得用gocov或gotestsum等工具 - 使用
go run main.go启动程序时，main()函数永远不会被go test统计到——它不属于任何可测试包
覆盖率本身不保证逻辑正确，但它能暴露哪些分支、错误路径、边界条件你根本没碰过。最值得盯住的不是百分比数字，而是那些「本该被测到却一片红」的函数——它们往往藏着没被触发的 panic、没走过的 error return，或者被遗忘的配置分支。
