go test -cover 输出的仅为语句执行粗略百分比，无法定位未覆盖行或分支；可靠覆盖率分析需用 -coverprofile 生成 profile 文件并配合 go tool cover 查看HTML报告。
go test -cover 输出的百分比，只是语句是否被执行过的粗略统计，并不能告诉你哪一行漏了、哪个 if 的 else 分支没走——它不生成可分析的数据，只算个数。
真正要定位问题、补测试、进 CI，必须用 -coverprofile 配合 go tool cover。这是 Go 原生覆盖机制的唯一可靠路径。
怎么快速看到当前包的覆盖率数字
在模块根目录下运行：go test -cover ./
它会递归跑所有子包的测试，终端输出类似：coverage: 65.2% of statements
但注意：这个值是每个包独立计算后加权平均的，不是整个项目“总行数被覆盖比例”；如果某个包没测试文件（比如命名不是 *_test.go 或放错目录），就会显示 0.0% 或报 no test files。
如何生成可点击的 HTML 覆盖率报告
两步走，缺一不可：
1. 先生成 profile 文件：go test -coverprofile=coverage.out -covermode=count ./
2. 再转成网页：go tool cover -html=coverage.out -o coverage.html
打开 coverage.html，绿色=已覆盖，红色=未覆盖，灰色=不可覆盖（空行、注释、default 分支等）。点击函数名能直接跳到源码位置。
⚠️ 常见错误：
- 直接用 go test -cover 就以为有报告了 → 实际没生成 .out 文件
- 在非原路径执行 go tool cover → 报 open xxx.go: no such file or directory，因为 profile 记的是绝对路径
- 用 -covermode=set（默认）却想看执行次数 → 换成 count 才能识别高频/低频路径
集成测试中为什么覆盖率总是 0%？
因为 go test -cover ./ 默认只统计测试文件所在包（比如 package main）的执行情况，而你真正想测的业务逻辑在 mypackage 里，它根本没被插桩。
正确做法是显式指定目标包：go test -cover -coverpkg=mypackage -coverprofile=coverage.out ./
如果业务包还依赖 utils 和 models，就得写全：go test -cover -coverpkg=mypackage,utils,models -coverprofile=coverage.out ./
✅ 关键点：
- -coverpkg 的参数是导入路径，不是文件路径
- 它会让编译器对这些包做插桩，哪怕它们的测试文件不在当前目录
- 集成测试覆盖率天然偏低（30–60% 合理），重点不是追求数字，而是确认关键错误分支（如网络超时、DB 约束失败）确实被触发过
-covermode=atomic 是 CI 中更安全的选择，尤其当测试启动 HTTP server 或 goroutine 时，count 模式可能因非原子计数导致漏统计；而 set 模式虽快，但连“是否执行过”都可能在并发下出错。实际项目里，别图省事，默认就用 atomic。
