go test -cover 报告为0%是因为默认只统计被显式执行的包，需在模块根目录运行或指定go test ./...；html报告需先用-coverprofile生成coverage.out，再用go tool cover -html生成；-covermode推荐count模式以准确反映分支覆盖。
go test -cover 报告为什么总是 0%？
不是代码没跑，而是默认只统计被 go test 显式执行的包——如果你在子目录下运行、或没指定包路径，cover 就会漏掉源码文件。常见现象是：明明写了测试，go test -cover 却显示 coverage: 0.0% of statements。
- 确保在模块根目录（含
go.mod的目录）下运行，或显式指定包：go test ./... - 避免在
internal/或cmd/子目录单独跑，除非你明确只想测那个子包 -
-cover不递归扫描未被测试引用的包，哪怕它在当前模块里
怎么生成可读的 HTML 覆盖率报告？
命令本身不输出 HTML，得靠 -coverprofile 先写中间文件，再用 go tool cover 渲染。漏掉任一环节都会卡在终端文本里。
- 先生成覆盖率数据文件：
go test -coverprofile=coverage.out ./... - 再转成 HTML：
go tool cover -html=coverage.out -o coverage.html -
coverage.out是纯文本，可 gitignore；coverage.html打开就能看高亮行，绿色=覆盖，红色=未覆盖
覆盖率数值不准？小心 -covermode 的三种模式差异
-covermode 决定统计粒度，不同模式结果可能差 20%+，尤其带分支或循环的函数。默认是 set（是否执行过），但容易高估真实覆盖质量。
-
-covermode=count：统计每行执行次数，适合分析热点和遗漏路径（推荐用于 CI） -
-covermode=atomic：并发安全计数，仅当测试用t.Parallel()时需要，否则和count行为一致 -
-covermode=set（默认）：只记“有/无”，if 分支里只进一个分支就标绿，实际逻辑未全验
CI 中集成覆盖率要注意什么？
CI 环境常因 GOPATH、模块路径或权限问题导致覆盖率文件为空或路径错乱，进而让阈值检查失效。
立即学习“go语言免费学习笔记（深入）”；
- 始终用绝对路径写
coverprofile，比如$(pwd)/coverage.out，避免相对路径在不同 step 中失效 - 检查
go test是否真执行了测试：加-v看输出，确认有=== RUN行 - 用
go tool cover -func=coverage.out提取汇总数据，方便脚本提取百分比，别依赖 HTML 文件解析
覆盖率数字本身不反映 bug 多少，但 count 模式下连续几行红色，往往意味着那个 if-else 或 error 分支根本没构造对应测试场景——这才是最该盯住的地方。
