go test -cover仅输出整体覆盖率百分比，无法定位未覆盖的代码行或分支；必须用-coverprofile=coverage.out生成profile文件，再通过go tool cover -html启动HTTP服务查看详细报告。
go test -cover 只输出百分比，不能定位问题
它只告诉你当前包语句覆盖率是 65.2%，但不会告诉你哪一行、哪个 else 分支、哪个 if err != nil 块被跳过。数字看着还行，关键错误路径可能全裸奔。
常见错误现象：go test -cover ./ 显示 90%+，点开 HTML 报告却发现大量红色——说明 -cover 没配合 profile 文件，纯属“假高分”。
- 它默认只统计当前目录下测试文件实际触发的语句，不递归子包，也不追踪依赖包调用
- 若测试没运行（比如
func TestXXX(t *testing.T)缺失或命名不规范），会直接报no test files或显示0.0% -
-cover默认用set模式，只记“执行过/没执行过”，无法识别分支遗漏（如只测了if没测else）
必须用 go test -coverprofile=coverage.out 生成 profile 文件
这是所有后续分析的唯一可靠起点。没有它，go tool cover 就是无米之炊。
容易踩的坑：
立即学习“go语言免费学习笔记（深入）”；
- 等号不能省：
-coverprofile=coverage.out✅；-coverprofile coverage.out❌（静默失败，文件不生成） - 多子包项目别用
./...或模糊路径；正确写法是go test -coverprofile=coverage.out -covermode=count ./（结尾三个点） -
coverage.out是二进制格式，不是文本，cat不出内容，也别提交进 Git（加进.gitignore） - 如果项目含集成测试且想统计业务包，必须加
-coverpkg=mypackage,utils，否则业务逻辑永远显示 0.0%
go tool cover -html=coverage.out 必须通过 HTTP 访问
直接双击生成的 coverage.html 会空白——这不是文件损坏，而是现代浏览器禁用了 file:// 协议下的 JS 执行，而报告依赖 JS 渲染高亮。
正确做法只有两种：
- 不加
-o：运行go tool cover -html=coverage.out，它自动起本地服务（默认端口59090），浏览器打开http://localhost:59090 - 手动起服务：在当前目录运行
python3 -m http.server 8000，然后访问http://localhost:8000/coverage.html - 绝对不要右键“在浏览器中打开”，也别挪动
coverage.out或 HTML 文件位置——Go 记录的是绝对路径，路径错一点就报open xxx.go: no such file or directory
看懂 HTML 报告里的颜色含义，别被灰色骗了
绿色 = 该行被执行 ≥1 次；红色 = 完全未执行（重点补测对象，如 else、default、错误处理分支）；灰色 = 不可执行代码（空行、注释、函数签名、type 定义、甚至 return 后面的语句）。
最容易被忽略的是：灰色不参与统计，不用写测试去“刷绿”。盯着灰色优化，等于白费力气。真正要盯的是红色行——尤其是那些看起来“理应走通”的错误分支和 context 取消路径。
