go tool cover -html 生成的 HTML 报告双击打不开是因浏览器禁用 file:// 协议加载本地 JS；正确做法是用 go tool cover -html=coverage.out 启动本地服务或用 python3 -m http.server 托管。
go tool cover -html 生成报告时打不开页面？
直接运行 go tool cover -html=coverage.out -o coverage.html 后双击打开 coverage.html，浏览器显示空白或报错 Failed to load resource: net::ERR_FILE_NOT_FOUND —— 这是因为生成的 HTML 依赖内联 JS 渲染，但某些浏览器（尤其 Chrome）对 file:// 协议加载本地 JS 有严格限制。
解决办法只有两个，且必须选其一：
- 用
go tool cover -html=coverage.out不加-o参数，它会自动启动本地 HTTP 服务（默认http://localhost:59090），浏览器访问该地址即可 - 手动起一个静态服务器：比如用 Python
python3 -m http.server 8000，然后把coverage.html放进当前目录，访问http://localhost:8000/coverage.html
别试图拖进浏览器或右键“在浏览器中打开”，这条路走不通。
覆盖率数据文件 coverage.out 是怎么来的？
coverage.out 不是手动生成的，必须由 go test 带 -coverprofile 参数产出。漏掉这步，go tool cover 就没输入可处理。
立即学习“go语言免费学习笔记（深入）”；
常见写法：
- 单包测试：
go test -coverprofile=coverage.out - 子目录递归（含子包）：
go test ./... -coverprofile=coverage.out - 想看函数级覆盖率（更细）：
go test -covermode=count -coverprofile=coverage.out（count模式记录执行次数，set模式只记是否执行过）
注意：-covermode=count 生成的 coverage.out 更大，但能支持热力图着色；如果只关心“有没有跑过”，用默认的 set 就够了，速度快、文件小。
为什么 HTML 报告里看不到 vendor 或第三方包？
go tool cover 默认只统计你项目里 import 的、且源码在工作区内的包。vendor 目录下的代码，或者通过 go mod download 缓存到 $GOPATH/pkg/mod 的依赖，默认不纳入统计范围 —— 这不是 bug，是设计如此。
如果你非要包含 vendor（比如离线 CI 场景），得确保测试时 go 命令能“看到”那些代码：
- 用
GO111MODULE=off go test -coverprofile=coverage.out（禁用 module，强制走 GOPATH + vendor） - 或把 vendor 路径显式加进
go test的包列表里：go test ./... ./vendor/github.com/some/lib -coverprofile=coverage.out（但要注意路径有效性）
不过绝大多数情况，测第三方包没意义，专注自己写的代码就行。
HTML 报告中某行标红但实际执行了？
标红表示“未覆盖”，但有时你确认那行逻辑肯定走过了，却还是红的 —— 最常见原因是：Go 的覆盖率统计基于 AST 插桩，对某些语法结构识别不一致。
典型触发点：
- 多返回值函数调用后直接赋值给多个变量，比如
a, b := fn()，插桩可能漏掉其中某个变量的赋值点 - 带 panic 的 defer，比如
defer func() { panic("xxx") }()，panic 之前的部分可能被误判为未执行 - 空 struct 字段、无副作用的类型断言（如
_ = x.(T)）也可能不被计入
这类问题不影响整体覆盖率数值，但会让局部判断失真。遇到时别硬改代码去“凑绿”，先确认逻辑是否真没被执行；如果确定执行了，大概率是工具局限，不是你的问题。
真正难搞的是并发测试中的覆盖率抖动 —— 同一份代码，多次 go test -cover 结果不同。这不是报告生成的问题，是并发路径非确定性导致的插桩采样偏差。这时候得靠 -covermode=count 多跑几次取平均，而不是信单次结果。
