go test -cover仅显示当前包覆盖率百分比；需-coverprofile生成数据并用go tool cover渲染html或函数报告；多包需分步生成再合并；0%覆盖可能是空函数体、内联优化或panic导致；html中灰色行属不可覆盖语句。
Go test -cover 生成覆盖率报告的基本命令
直接运行 go test -cover 就能拿到当前包的覆盖率百分比，比如输出 coverage: 65.2% of statements。这适合快速验证，但不生成可读报告。
真正要分析哪行没覆盖，得用 -coverprofile 输出原始数据，再用 go tool cover 渲染：
-
go test -coverprofile=coverage.out：生成二进制格式的覆盖率数据文件 -
go tool cover -html=coverage.out -o coverage.html：转成带高亮的 HTML 页面，点击函数可跳转到源码行 -
go tool cover -func=coverage.out：按函数列出覆盖率，适合 CI 日志中快速扫描低覆盖函数
跨多个包时 coverprofile 路径和合并问题
默认 go test ./... 不会自动合并子包的覆盖率——每个包单独跑，-coverprofile 只写入当前包的结果。常见错误是只看到 main 包的覆盖率，忽略 internal 或 service 子目录。
正确做法是分步生成再手动合并：
- 先用
go test -coverprofile=coverage-foo.out ./foo/...对每个子模块单独跑 - 用
go tool cover -func=coverage-*.out | grep -v "mode:" > coverage-summary.txt提取函数级汇总（注意过滤掉 mode 行） - 或者用第三方工具如
gocov或gotestsum自动合并，但原生go tool cover不支持多文件直接合并
别指望 go test ./... -coverprofile=coverage.out 一次生成全量报告——它只会覆盖最后一次包的输出。
测试未覆盖但实际执行的代码为什么显示 0%
典型现象：某函数在测试中明确调用了，go tool cover -html 却标红显示 0%。根本原因不是没执行，而是 Go 的覆盖率统计粒度是「可执行语句」，不是「函数入口」。
以下情况会导致看似矛盾的 0%：
- 函数只有签名、没有函数体（比如接口方法声明或空实现
func Foo() {}），不计入统计范围 - 使用了
//go:noinline或编译器内联优化后，部分语句被折叠，覆盖数据无法映射回源码行 - 测试 panic 退出过早，后续语句没走到，但 go test 把 panic 当作失败而非未覆盖
- 条件分支里有 unreachable code（比如
if false { ... }），Go 编译器可能直接丢弃，cover 工具也看不到它
HTML 报告里灰色行代表什么
打开 coverage.html 时，有些代码行是灰色而非红色或绿色——这不是 bug，而是 cover 工具对「不可覆盖语句」的标记。
灰色行包括：
- 空行、纯注释行、函数签名行、
}结束符 - 类型定义、常量声明、变量声明（无初始化表达式）
- 被编译器判定为 dead code 的分支（如
if runtime.GOOS == "windows" { panic("not supported") }在 Linux 下跑时，整个块可能灰掉）
灰色 ≠ 漏测，只是不在覆盖率统计范围内。别花时间给注释写测试用例。
