go test -cover 默认只显示覆盖率百分比，不生成 profile 文件；需加 -coverprofile=coverage.out 参数才能生成可分析的 coverage.out 文件，否则 go tool cover -html 会报错“no such file”。
go test -cover 为什么只显示百分比，不生成报告
因为 go test -cover 默认只输出覆盖率摘要，不保存中间数据。想可视化，得先生成 profile 文件。
- 必须加
-coverprofile=coverage.out参数，否则没文件可分析 - 如果测试用例没跑完（比如 panic 或 timeout），
coverage.out可能为空或不完整 - 多个包一起测时，
-covermode=count比atomic更准，但会稍慢；并发测试建议用atomic
go tool cover -html 报错 open coverage.out: no such file
这是最常见卡点：profile 文件根本没生成，或者路径不对。
- 确认命令是
go test -coverprofile=coverage.out ./...（注意./...表示当前模块所有子包） - 如果在子目录下执行，
coverage.out会写到当前目录，但后续go tool cover -html要在同目录运行 - Windows 下路径分隔符不影响，但文件名大小写敏感（
Coverage.out≠coverage.out） - CI 环境中常因工作目录切换导致路径错位，建议用绝对路径或统一 cd 到 module root 再执行
HTML 报告里大量灰色代码块，实际没被覆盖
灰色代表“未执行”，但不一定是有 bug —— 很多是编译器注入的代码（如接口转换、goroutine 启动桩）或未导出函数。
- 关注绿色（已覆盖）和红色（未覆盖）行，灰色可忽略
- 如果某函数整块灰，检查是否被内联（
//go:noinline可禁用，用于调试） - test 文件里的辅助函数默认不计入覆盖率，除非显式用
//go:build ignore外移 -
go tool cover -func=coverage.out可快速看各函数覆盖率，比扫 HTML 更快定位低覆盖函数
如何合并多个 coverage.out 文件做全局统计
Go 原生命令不支持直接合并，得靠第三方工具或手动拼接，但有坑。
立即学习“go语言免费学习笔记（深入）”；
- 用
gocovmerge（go install github.com/ory/go-acc@latest）可合并多个.out文件，但要求所有 profile 用相同-covermode - 手动合并容易出错：每行格式为
file.go:12.3,15.4 1 1，第二列是调用次数，直接 cat 会重复计数 - 更稳的做法是统一用
go test -coverprofile=coverage.out -covermode=count ./...单次跑全量，避免拆分 - 某些 IDE（如 GoLand）能自动聚合多包覆盖率，但底层仍是调用
go tool cover，依赖 profile 文件完整性
真正难的不是生成 HTML，而是搞清哪一行“该被覆盖却没被覆盖”——比如 error path、边界条件、panic 分支。这些地方往往藏在 if 的 else 里，或者 defer 中，容易被测试忽略。
