必须分两步：先go test -coverprofile=coverage.out采集行级执行数据，再go tool cover -html=coverage.out启动HTTP服务查看可视化报告；-cover仅输出百分比且不保存细节，无法定位未覆盖行。
直接生成可用的 HTML 覆盖率报告，必须分两步：先用 go test -coverprofile=coverage.out 采集数据，再用 go tool cover -html=coverage.out 启服务查看——缺一不可，只跑 go test -cover 等于没做。
为什么 go test -cover 只输出一行数字，却看不到哪行没测到
因为 -cover 本身不保存任何行级信息，它只是调用底层统计后立刻丢弃，只留个百分比。真正记录“第 42 行执行了 3 次”这种细节的，只有 -coverprofile 输出的二进制文件。常见误操作包括：
- 写成
go test -coverprofile coverage.out（中间是空格）→ 静默失败，coverage.out文件根本不会生成 - 在错误目录下执行，比如从子包里跑
go test -coverprofile=coverage.out ./→ 路径解析错乱，HTML 报告点文件时报open xxx.go: no such file or directory - 测试函数名不是
TestXXX或参数不是*testing.T→ 测试压根没被发现，coverage.out内容为空或极低
-covermode=count 和 -covermode=set 的实际区别在哪
默认 set 模式只记“这行有没有被执行过”，对 if/else、switch/default 这类分支覆盖情况完全无感；而 count 模式会真实记录每行执行次数，HTML 报告中绿色深浅还能反映频次差异（虽不显式标数字，但高亮逻辑依赖它）。关键影响：
- 用
set时，一个if x > 0 { A } else { B }只测了 A 分支，B 行仍标红——你能看到问题，但不知道是否漏测 - 用
count时，A 行显示执行 5 次、B 行为 0 次，立刻确认是分支覆盖缺失，而非采集失败 - CI 中设阈值告警（如
go tool cover -func=coverage.out | grep "myapp/"）也必须基于count，否则加权平均不准
生成 coverage.out 后，coverage.html 打不开或全白屏
这不是文件损坏，是现代浏览器禁用了 file:// 协议加载 JS —— 而 HTML 报告必须靠 JS 渲染行级高亮。唯一可靠解法只有两个：
立即学习“go语言免费学习笔记（深入）”；
- 不加
-o，直接运行go tool cover -html=coverage.out→ 它自动起 HTTP 服务，默认监听http://localhost:59090 - 手动起服务：
python3 -m http.server 8000，把coverage.html放当前目录，访问http://localhost:8000/coverage.html - 绝对不要双击打开、不要拖进浏览器、不要改后缀名——路径偏移 1 字符，报告就找不到源码文件
HTML 报告里灰色、红色、绿色行到底代表什么
颜色不是装饰，是语义标记，直接影响你该不该补测试：
- 绿色：该行被执行 ≥1 次（但不保证分支全覆盖，比如只走了
if分支，else仍是红色） - 红色：该行完全未执行（含 error return、panic 分支、default case、未 mock 的外部调用路径）——这是真要补测试的地方
- 灰色：空行、注释、函数签名、
type定义、甚至没写的default分支——这些不参与覆盖率计算，也不该去写测试“刷绿”
最容易被忽略的是：灰色行不是“未覆盖”，而是“不可覆盖项”；盯着灰色优化，等于拿锤子砸空气。
