go test -cover 显示 0.0% 的主要原因是未运行任何测试函数，常见于测试文件名不以 _test.go 结尾、测试函数命名不规范（如未以 Test 开头或参数非 *testing.T）或未在正确包路径下执行。
go test -cover 为什么显示 coverage: 0.0%？
常见原因是没运行任何测试函数，或者测试文件没被识别。Go 要求测试文件名以 _test.go 结尾，且测试函数必须是 func TestXxx(*testing.T) 形式，首字母大写。如果只写了 func testFoo() 或者文件叫 util_test.go.bak，go test 就会跳过它们，导致覆盖率始终为 0。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
go test -v看实际执行了哪些Test函数，确认有输出 - 检查当前目录下是否有
*_test.go文件，且没有拼写错误（比如xxx_test.go~是不会被加载的） - 如果项目有子模块或嵌套包，要进到具体包路径下运行
go test，不能只在根目录用go test ./...就默认覆盖全部
生成 coverprofile 文件后怎么查看详细行覆盖率？
go test -coverprofile=coverage.out 只生成二进制 profile 数据，没法直接读。得用 go tool cover 转成可读格式。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 生成 HTML 报告最直观：
go tool cover -html=coverage.out -o coverage.html，然后用浏览器打开coverage.html - 想看纯文本摘要，用
go tool cover -func=coverage.out，它会按函数列出覆盖率百分比和行数范围 - 注意：HTML 报告里的「红色高亮」不一定是未执行，也可能是不可达代码（如
if false { ... }），Go 的覆盖率统计的是「是否被执行过」，不是「是否被条件覆盖」
多个包一起测时 coverprofile 合并容易出错
go test ./... -coverprofile=coverage.out 看似方便，但 Go 默认只会把最后一个包的覆盖率写进 coverage.out，前面的全被覆盖。结果就是你看到的数字只是某个子包的，不是整体。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
go test -coverprofile分别生成每个包的 profile（如pkg1.out、pkg2.out），再用go tool cover -func分别看 - 真要合并，得用第三方工具如
gocov或gotestsum，原生go tool cover不支持多文件合并 - CI 场景下更推荐单包测试 + 单独上传报告，避免合并逻辑引入偏差
覆盖率数值高 ≠ 代码质量好，这些地方常被误判
Go 的 -cover 默认用 count 模式（记录每行执行次数），但很多人没意识到：空行、注释、函数签名、case 标签本身都不计入统计范围；而像 if err != nil { return } 这种单行提前返回，只要 err 为 nil 就整行不计，但其实逻辑分支没被验证。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 不要只盯总百分比，重点看
go tool cover -func输出里那些0.0%的函数，尤其是错误处理分支 - 慎用
-covermode=atomic（多 goroutine 安全），它比默认count慢不少，本地开发没必要开 - 接口实现、方法重写、panic/recover 这类边界逻辑，即使覆盖率 100%，也不代表行为正确——得靠测试断言，不是靠行数覆盖
真正难覆盖的从来不是代码行数，而是状态组合、时序依赖和异常传播路径。profile 文件只是快照，不是质量证明。
