go test -cover 仅统计当前包语句覆盖率,需用 -coverpkg 指定被测包、-coverprofile 生成 profile 并配合 go tool cover -html 查看具体行覆盖情况。

怎么用 go test -cover 快速看当前包覆盖率
直接在包目录下运行 go test -cover,终端会输出类似 coverage: 65.2% of statements 的一行结果。它只统计当前目录下被测试文件(*_test.go)实际调用到的语句,不递归子包,也不覆盖依赖包。
- 如果显示
0.0%或报no test files,先检查测试文件名是否合规、是否在正确路径下 -
-cover默认用set模式(只记“执行过/没执行过”),速度快,但无法区分分支是否全覆盖 - 别指望它告诉你哪行漏了——这只是一个概览数字,定位问题必须生成 profile 文件
为什么 go tool cover -html 才是真·排查主力
要看到具体哪一行红(未覆盖)、哪一行绿(已覆盖),必须走完三步:go test -coverprofile=coverage.out → go tool cover -html=coverage.out -o coverage.html → 用浏览器打开 coverage.html。
-
coverage.out是二进制格式,cat不出来内容,也别提交进 Git(加进.gitignore) - 如果打开 HTML 报告时提示
open xxx.go: no such file or directory,说明你不在生成 profile 的原始路径下运行命令——Go 记录的是绝对路径,必须回到原目录再执行go tool cover - 灰色行是空行、注释或不可达代码(如
return后面的语句),它们不参与统计,不用补测
集成测试里业务包覆盖率总为 0%?一定是漏了 -coverpkg
当你在 main_test.go 或 e2e/ 目录下跑 HTTP 端到端测试,go test -cover ./ 默认只统计 main 包自身,根本不会追踪对 mypackage 的调用——所以你会看到业务包显示 0.7% 这种失真数据。
- 必须显式加
-coverpkg=mypackage,告诉编译器:“我要监控这个包里所有语句是否被本次测试触发” - 多个包就用逗号分隔:
-coverpkg=mypackage,utils,models;路径要和go list -f '{{.ImportPath}}' ./mypackage输出一致 - 若想只看集成测试贡献的覆盖(排除单元测试干扰),可加
-run=^TestIntegration过滤测试函数名
-covermode=count 和 -covermode=atomic 到底选哪个
默认的 set 模式只能回答“有没有执行”,而 count 和 atomic 能记录执行次数,这对分析分支遗漏更有效(比如一个 if/else 块只进了 if,else 部分在 HTML 报告里就是红色,且 -func 输出中该函数覆盖率会明显偏低)。
立即学习“go语言免费学习笔记(深入)”;
-
-covermode=count:记录精确次数,适合本地调试热点或补漏,但多 goroutine 下可能不准 -
-covermode=atomic:线程安全计数,CI 中推荐使用;生成的.out文件仍可用go tool cover -html解析 -
-covermode=count生成的 profile 不能直接用go tool cover -func算百分比——它需要先聚合,而atomic和set可直接解析
真正卡住人的从来不是命令记不住,而是忘了 -coverpkg 要显式声明被测包、coverage.out 必须在原路径下解析、以及 HTML 报告里的红色不等于 bug——它只是提醒你:“这段逻辑,在这次测试里,一次都没走过”。










