go test -cover 是 Go 官方内置的覆盖率统计功能，通过编译期插桩记录语句执行情况，计算“已覆盖语句数 / 总可执行语句数”百分比，用于定位未测分支而非追求高数值；需配合 -coverprofile 生成数据、go tool cover -html 可视化，并用 -coverpkg 扩展统计范围，CI 中需脚本校验阈值。
go test -cover 不是第三方工具，而是 Go 官方测试命令内置的覆盖率统计能力——它通过编译期插桩（instrumentation），在运行测试时记录每条可执行语句是否被执行过，最终算出“被覆盖的语句数 / 总可执行语句数”的百分比。
这个数字本身不保证质量，但能快速暴露没写测试的分支、漏测的错误路径、或压根没走过的逻辑块。真正有用的是：用它来定位该补什么测试，而不是盯着 92.3% 欣喜若狂。
怎么跑出覆盖率数字？基础命令别写错
最简命令就是：
go test -cover它只输出一行结果，例如：
PASS coverage: 75.3% of statements。注意三点：
-
-cover默认只统计当前包（即你cd进入的那个目录下的代码），不会递归子包或依赖包 - 它不生成任何文件，纯终端输出；想存下来分析，必须加
-coverprofile - 如果测试失败（
FAIL），覆盖率不会输出——得先让测试过，再谈覆盖
怎么生成 HTML 报告看哪行没测？关键三步不能跳
要可视化到具体哪一行红（未覆盖）、哪一行绿（已覆盖），必须走完这三步：
- 执行：
go test -coverprofile=coverage.out
（生成二进制覆盖率数据） - 转换：
go tool cover -html=coverage.out -o coverage.html
（生成 HTML 文件） - 打开：
coverage.html，浏览器里点文件名就能跳转到源码行——灰色是空行/注释，不参与统计
⚠️ 常见坑：coverage.out 是二进制格式，直接 cat 看不到内容；也别把它提交进 Git——记得加进 .gitignore。
多个包一起测覆盖率？-coverpkg 和 ./ 的区别得拎清
想统计整个模块（含 receiver/、exporter/ 等子包）的总覆盖率，不能只写 go test ./...，否则只覆盖测试文件所在包。
- 正确姿势：
go test -coverprofile=coverage.out -coverpkg=./ ./
其中第一个./是-coverpkg的目标（告诉 Go：“这些包的语句我都想统计”），第二个./是实际要运行测试的包范围 - 如果只想测特定几个包，比如
confmap和config：go test -coverprofile=coverage.out -coverpkg=go.opentelemetry.io/collector/confmap,go.opentelemetry.io/collector/config ./...
-
-coverpkg不等于-cover的作用范围——它只是“扩大统计口径”，不运行对应包的测试，照样能统计其被调用语句的覆盖情况
CI 里卡覆盖率下限？别信单行命令能搞定
Go 没有原生 --min-cover=80 这种参数。想在 CI 中失败低覆盖率，得自己解析 coverage.out 或终端输出：
- 简单脚本提取数字：
go test -cover | grep -o '[0-9.]\+%' | head -1 | sed 's/%//' | awk '{if ($1 < 80) exit 1}' - 更稳的方式是用
go tool cover -func输出函数级明细，再用awk算 total 行的百分比值 - 注意：
-covermode=atomic在并发测试中更准确（尤其 CI 多核跑），但会稍慢；默认count模式在单测里够用
真正容易被忽略的是：覆盖率阈值必须按模块分级设定——核心组件（如 Collector 的 pipeline）要求 85%+，而工具类包（如 internal 下的辅助函数）70% 就合理。一刀切只会催生“为覆盖而覆盖”的无效测试。
