go test -cover仅统计被测试用例直接或间接执行的代码，不覆盖main函数、未import工具函数、条件编译排除文件及go:generate生成代码；覆盖率高不等于逻辑安全，如空函数调用也被计为覆盖。
go test -cover 能测出哪些代码没跑过
它只统计被 go test 执行到的包内源文件，不会自动包含 main 函数、未被测试用例 import 的工具函数、或编译时被条件编译排除的代码（比如带 // +build ignore 的文件）。覆盖率数字高≠逻辑安全——比如一个 if 分支里只调了空函数，也会被算作“已覆盖”。
- 默认只统计当前目录下被测试文件 import 的包，子目录需显式指定路径，如
go test ./... -cover -
switch语句中未写default且所有case都被触发，仍会显示该switch块为 100% 覆盖，但实际缺少兜底逻辑验证 - 使用
go:generate生成的代码默认不参与统计，除非生成后的文件被测试直接引用并执行
怎么让覆盖率报告更准：-covermode=count 和 -covermode=atomic 的区别
-covermode=count 记录每行被执行次数，适合定位“哪些分支根本没走”，但并发测试下可能漏计数；-covermode=atomic 用原子操作累加，多 goroutine 场景下更可靠，代价是稍慢一点、且无法用于 go test -race 同时运行（会报错 cannot use -race and -covermode=atomic together）。
- 单测无并发时，两者结果一致，推荐用
count，速度快、输出易读 - 测试中启用了 goroutine（比如调
http.ListenAndServe或用time.AfterFunc），必须用atomic，否则覆盖率数值可能偏低 -
-covermode=func只告诉你函数是否被调用过，粒度太粗，基本不用
生成 HTML 报告后点不开具体文件？路径问题怎么解
执行 go test -coverprofile=coverage.out && go tool cover -html=coverage.out -o coverage.html 后，HTML 中点击文件名跳转失败，大概率是因为 go tool cover 默认按 GOPATH 或 module 根路径解析源码位置，而你的编辑器或浏览器打开 coverage.html 时不在原项目根目录下。
- 务必在项目根目录（即
go.mod所在目录）运行命令，否则路径映射错乱 - 如果项目用了 vendor，确保
go test没加-mod=vendor以外的干扰参数，否则 cover 工具可能找不到原始源码 - Windows 下注意路径分隔符，
go tool cover对反斜杠支持不稳定，统一用正斜杠或 cd 到路径中避免空格和中文
CI 里上传覆盖率到 codecov / coveralls 失败的常见原因
不是 token 错就是文件格式或路径对不上。这些平台不接受裸的 coverage.out，得先转成它们认的格式（比如 codecov 推荐用 gocov 或 gotestsum 中间转换），而且要求路径能和仓库 Git 树结构对齐。
立即学习“go语言免费学习笔记（深入）”；
- 用
go test -coverprofile=coverage.out -covermode=count ./...生成后，别直接上传coverage.out，它只是 Go 内部格式 - codecov 官方 bash 脚本会自动调
gocov转换，但前提是你的GO111MODULE=on且 GOPROXY 正常，否则go get github.com/axw/gocov/...会失败 - GitHub Actions 中若用
actions/checkout@v4，默认不 fetch tags 和 history，导致 codecov 无法关联 commit，需加fetch-depth: 0
覆盖率本身不保证质量，但它是个诚实的镜子——照出你没碰过的那几行，往往就是下次 panic 的起点。
