go test -cover 显示 0.0% 是因未运行测试，常见原因包括_test.go 文件名错误、测试函数未以 Test 开头、未在正确路径执行或缺少 Test 函数；需先用 go test -v 确认输出 === RUN TestXXX。
直接跑 go test -cover 只能看个数字，定位不到哪行漏了；真要查漏补缺，必须生成 coverage.out 文件再用 go tool cover 分析。
为什么 go test -cover 总是显示 0.0%？
这不是覆盖率低，而是压根没跑测试。常见原因有：
-
*_test.go文件名拼错（比如util_test.go~或test_util.go） - 测试函数没以
Test开头，或参数不是*testing.T - 在错误路径下执行命令——比如项目有
pkg/http子包，却在根目录只跑go test -cover，它只会查当前目录，不会自动进子包 - 没写任何
func TestXxx，只写了func main或辅助函数
先运行 go test -v，确认终端输出了 === RUN TestXXX 才算真正触发了测试。
如何生成可定位的覆盖率数据文件
go test -coverprofile=coverage.out 看似简单，但几个关键点不注意就会白干：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 必须加
-covermode=count（推荐）或-covermode=atomic，否则默认set模式无法识别分支覆盖情况 - 想覆盖整个模块所有子包，命令末尾要写
./，而不是空着或只写.；否则coverage.out里只存最后一个包的数据 - 生成
coverage.out的路径，就是后续运行go tool cover的路径——如果移走了文件或切了目录，go tool cover -html=coverage.out会报open xxx.go: no such file or directory - 跨包调用（比如
pkg1调了pkg2的函数），得显式加-coverpkg=./，否则pkg2的代码行不会被计入
怎么快速定位未覆盖的函数或代码行
有了 coverage.out，下一步不是直接开 HTML，而是先用文本命令筛重点：
-
go tool cover -func=coverage.out：列出每个函数的覆盖率，一眼看出哪个函数是 0.0%，优先补测 -
go tool cover -html=coverage.out -o coverage.html：生成网页，绿色=已覆盖，红色=未覆盖，灰色=不可覆盖（如空行、注释、default分支） - HTML 报告里点击函数名能跳转到具体源码位置，但注意：它高亮的是「整行」，不是「条件分支」；比如
if err != nil { return }这种单行提前返回，只要err是nil，整行就不计数，但你其实没验证err != nil分支
CI 中校验覆盖率阈值要注意什么
别信 go test -cover 输出的最后一行百分比——它只是某个包的，不是汇总值。CI 里必须从 coverage.out 提取：
- 用
go tool cover -m coverage.out | tail -n +2提取每行覆盖率数据，再算平均值 - 用
-covermode=atomic生成 profile，避免并发测试时计数丢失 - 如果项目有多个子模块，原生工具不支持合并多个
.out文件，得靠gocovmerge这类第三方工具，否则阈值检查毫无意义
覆盖率数值本身不能代替逻辑验证；if x == nil { return } 被标绿，不代表你测过 x != nil 的场景。
