go 语言代码覆盖率是边写测试边暴露问题的实时反馈工具，需注意_test.go命名、test函数规范、-coverpkg跨包覆盖、路径一致性、-covermode选择及聚焦业务逻辑分支覆盖。
Go 语言的代码覆盖率不是“学完再用”的知识点，而是边写测试边暴露问题的实时反馈工具。它不依赖额外库，但默认行为容易让人误以为测试跑成功了——其实可能根本没测到业务代码。
为什么 go test -cover 总是显示 0.0% 或 no tests to run
这不是覆盖率低，是测试压根没触发。常见原因有：
-
_test.go文件名拼错：比如util_test.go~（编辑器临时文件）、test_util.go（下划线位置错） - 测试函数没以
Test开头，或参数不是*testing.T - 在错误目录执行：比如项目结构是
./internal/http，却在根目录只跑go test -cover，它默认只查当前目录，不会自动进子包 - 没写任何
func TestXXX(t *testing.T)，只有辅助函数或main
先跑 go test -v 看终端是否输出 === RUN TestXXX —— 没这行，就别谈覆盖率。
-coverpkg 是跨包覆盖的关键开关
默认情况下，go test 只对测试文件所在包插桩。哪怕你的 TestMain 启动了 http.ListenAndServe，./internal/server 里的代码也不会出现在 profile 里。
必须显式声明要覆盖的包范围：
- 覆盖整个模块所有子包：
go test -covermode=count -coverprofile=coverage.out -coverpkg=./ ./ - 只覆盖特定几个包：
go test -covermode=count -coverprofile=coverage.out -coverpkg=./internal/http,./internal/model ./
注意：-coverpkg=./ 中的 ./ 是相对路径，必须在 go.mod 所在目录执行；末尾的 ./ 是执行目标，漏掉会导致 coverage.out 只有零星几行数据。
生成 HTML 报告后点不开源码？90% 是路径问题
coverage.out 记录的是源码的绝对路径。你在 CI 容器里生成，本地打开 coverage.html 就会报 open xxx.go: no such file。
解决方法：
- 务必在项目根目录（
go.mod所在路径）运行命令 - Windows 下统一用正斜杠
/，避免反斜杠解析失败 - 路径中含空格或中文时，先 cd 进去再执行，别用带空格的绝对路径
- 如果仍打不开，改用
go tool cover -func=coverage.out查函数级汇总，更稳
-covermode=count 和 -covermode=atomic 怎么选
两者都记录执行次数，区别在于并发安全：
-
count：速度快，输出易读；适合单测无 goroutine 的场景 -
atomic：用原子操作累加，多 goroutine 场景下不丢计数；但不能和-race同时用（会报错cannot use -race and -covermode=atomic together）
只要测试里启用了 goroutine（比如调了 http.ListenAndServe、用了 time.AfterFunc），就必须用 atomic，否则覆盖率数值可能偏低。
真正难的不是生成报告，而是理解哪些“红色”行值得补测试——比如 init 函数标红，不是 bug，是工具设计如此；空 else 块不计入统计，也不该为它写测试。重点盯住业务逻辑里那些被调用却未覆盖的分支，而不是追求 100% 数字。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
