go test -cover 输出 0.0% 或 no test files 是因测试未执行，需确认是否在含 *_test.go 的目录下运行且文件名符合规范；-coverprofile 为空需加 -coverpkg 指定被测包；灰色代码表示不可覆盖或未执行路径。
go test -cover 输出 0.0% 或 no test files 怎么办
这通常不是覆盖率低，而是测试根本没跑起来。先确认两件事：go test 是否在正确的包路径下执行（必须是含 *_test.go 文件的目录），以及测试文件名是否严格符合 xxx_test.go 格式（不能是 test_xxx.go 或漏掉 _test）。
常见卡点：
-
go test默认只跑当前目录，不会递归子包；想测./pkg/http就得明确写go test ./pkg/http - 如果项目用了 Go modules，但当前目录不在 module root 下，
go test可能找不到依赖包，导致测试编译失败、静默跳过 -
go test -cover不会运行init()函数或未被任何测试调用的包级变量初始化逻辑——这些代码天然不计入统计
go test -coverprofile=coverage.out 生成的文件为空或只有几行
这是因为没指定要覆盖的包范围。-coverprofile 本身不决定“覆盖谁”，它只记录实际执行到的代码行；而默认情况下，go test 只插桩当前包（即测试文件所在目录），不会自动包含它所 import 的业务包。
必须加 -coverpkg 显式声明：
立即学习“go语言免费学习笔记（深入）”；
- 覆盖当前模块所有子包：
go test -coverprofile=coverage.out -coverpkg=./ ./... - 只覆盖特定子包：
go test -coverprofile=coverage.out -coverpkg=./pkg/http,./pkg/model ./... - 漏掉
-coverpkg，哪怕测试调用了pkg/http.Serve()，pkg/http里的代码也不会被插桩，自然不出现在coverage.out里
go tool cover -html 打开后全是灰色，没有红绿高亮
灰色代表“不可覆盖”，比如空行、注释、default 分支、func main() { ... } 里未执行的语句——但这不等于你没测到。更可能是：测试根本没触发对应代码路径。
快速验证方法：
- 用
go tool cover -func=coverage.out看函数级统计，找覆盖率明显偏低的函数名 - 检查该函数是否被测试显式调用；如果是 HTTP handler，确认测试请求的 URL 和 method 是否匹配路由注册方式
- 集成测试中若用
httptest.NewServer，它只包装http.Handler，不会执行main()或服务启动逻辑；要覆盖那些代码，得启动真实进程并用-covermode=count+-test.coverprofile
CI 中校验覆盖率阈值为什么总是失败
直接用 go test -cover 提取的百分比不可靠——它只统计当前包，且模式是 set（布尔型），不反映分支覆盖情况。CI 需要的是可重复、可比对的数值。
正确做法分三步：
- 生成 profile 时固定用
-covermode=atomic（并发安全，避免计数丢失）：go test -coverprofile=coverage.out -covermode=atomic ./ - 从
coverage.out提取平均覆盖率（不是-cover输出的那一行）：go tool cover -m coverage.out | tail -n +2 | awk '{sum += $3} END {print sum/NR}' - 注意：有些行（如
switch的default、if err != nil后的 panic）在语法上无法被覆盖，它们会被计入分母但永远为 0，拉低整体值——这不是 bug，是 Go 覆盖率模型的固有行为
真正难搞的从来不是命令怎么敲，而是让测试实际走到你想看的那几行代码里。覆盖率数字只是镜子，照出的是测试设计的盲区，不是代码本身的对错。
