go test -cover 的百分比仅反映语句执行比例，不保证逻辑正确性；95% 覆盖率仍可能线上 panic，因未覆盖 error 分支、边界条件或并发路径，需结合 -func 报告定位零覆盖函数并针对性补测。
go test -cover 输出的百分比只是语句覆盖率，且只统计当前包中被测试用例**实际执行到的代码行**。它不等于逻辑安全，也不代表所有分支、错误路径或边界条件都被验证过。
为什么 go test -cover 显示 95% 却还线上 panic？
因为覆盖率工具只看“是否执行”，不关心“是否测对”。常见漏点包括：
-
if err != nil块里调了log.Fatal或直接panic，但测试始终 mock 成功返回，该分支压根没进 - HTTP handler 中对
json.Unmarshal错误的处理写在 else 里，但测试全用合法 JSON，err永远为nil - 函数接收
context.Context，但测试只传context.Background()，ctx.Err() != nil分支从未触发 - switch 语句缺
default，所有 case 都覆盖了，覆盖率显示 100%，但缺失兜底逻辑验证
-covermode=count 和 -covermode=atomic 怎么选？
两者都记录执行次数，但并发安全性不同：
-
-covermode=count：快、输出易读，适合单协程测试；但在多 goroutine 场景下计数可能不准（比如http.ListenAndServe启动服务后发请求） -
-covermode=atomic：用原子操作累加，多 goroutine 下可靠；但不能和-race同时用（会报错cannot use -race and -covermode=atomic together） - CI 环境建议统一用
atomic，本地开发快速验证可用count
HTML 报告点不开源码文件？路径映射错了
go tool cover -html=coverage.out 生成的链接默认按模块根目录（即 go.mod 所在路径）解析源码位置。常见问题：
- 不在模块根目录下运行命令 → 浏览器点击跳转 404
- 项目用了
vendor，但go test加了-mod=vendor以外的参数 → cover 工具找不到原始源码 - Windows 下路径含反斜杠（
\）→go tool cover解析不稳定，建议统一用正斜杠或cd进入路径
怎么定位真正该补的测试，而不是刷数字？
别盯着总百分比，用 go tool cover -func=coverage.out 看函数级明细：
- 重点关注
coverage: 0.0%或33.3%的函数——它们往往藏着未触发的else、defer清理、或return err分支 - 对每个返回
error的外部调用（如 DB 查询、HTTP 请求），至少写两个测试 case：一个成功，一个显式 mock 失败 - 空切片
[]string{}和 nil 切片var s []string在len(s) == 0后行为可能不同，都要覆盖
if err != nil { return err } 这种关键错误传播路径一直标红却视而不见。工具只告诉你“没跑过”，至于“为什么没跑、该不该跑、跑错了怎么办”，得靠人来判断。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
