coverage.out 是 Go 内部二进制编码的覆盖率数据文件，非人类可读，必须用 go tool cover 解析；直接 cat 或编辑器打开仅显示乱码或空内容，且其路径为相对当前工作目录。
go test -coverprofile 生成的文件到底是什么格式？
它不是人类可读的文本，而是 Go 内部二进制编码的覆盖率数据（coverage profile），必须用 go tool cover 解析。直接 cat 或用编辑器打开只会看到乱码或空内容——这是最常被卡住的第一步。
- 生成命令必须带
-covermode=count（推荐）或-covermode=atomic，否则默认的set模式只记录“是否执行过”，无法支持函数级/行级统计和 HTML 报告 -
-coverprofile=coverage.out的路径是相对当前工作目录的，不是相对于go.mod；若在子目录运行，别漏掉../coverage.out这类路径 - 并发测试下，
-covermode=count可能因竞态导致计数不准，高并发场景优先选-covermode=atomic
怎么用 go tool cover 看具体哪几行没覆盖？
先生成 profile，再用 go tool cover 查看细节：
go test -covermode=count -coverprofile=coverage.out ./... go tool cover -func=coverage.out
输出类似：
github.com/user/proj/handler.go:12: ServeHTTP 85.7% github.com/user/proj/handler.go:45: parseQuery 0.0%
-
-func显示每个函数的覆盖率百分比，按行号排序，一眼定位低覆盖函数 - 想查单个文件，加
-o过滤：go tool cover -func=coverage.out | grep handler.go - 注意：
-func不显示未执行的行号，只给汇总；要看具体哪些行空白，得用-html
生成 HTML 报告时为什么打开是空白页？
常见原因就两个：profile 文件为空，或浏览器安全策略阻止本地 file:// 加载 JS。
立即学习“go语言免费学习笔记（深入）”；
- 先确认
coverage.out非空：ls -l coverage.out，0 字节说明测试根本没跑出覆盖率（比如没加./...或包路径写错） - 生成命令要完整：
go test -covermode=count -coverprofile=coverage.out ./...，漏掉./...就不会扫描子包 - HTML 报告必须用
go tool cover -html=coverage.out -o coverage.html生成，然后用open coverage.html（macOS）或双击打开——别用 VS Code Live Server 等工具，它会改路径导致 JS 加载失败 - Chrome 下若报
Refused to execute script，说明是 file 协议限制，换 Safari 或用python3 -m http.server 8000起个本地服务再访问http://localhost:8000/coverage.html
多包合并覆盖率时 coverprofile 怎么处理？
Go 原生命令不支持直接合并多个 .out 文件，得靠 gocov 或手动拼接（不推荐）。更稳的方式是：统一在项目根目录执行，用 ./... 扫描全部子包，一次生成全量 profile。
- 如果必须分步（如 CI 中分模块测试），可用
gocov工具：go install github.com/axw/gocov/gocov@latest，然后gocov merge coverage1.out coverage2.out > merged.out - 合并后仍需用
go tool cover处理：go tool cover -func=merged.out或-html - 注意：
gocov生成的 merged.out 是 text 格式，而原生go test -coverprofile输出的是 binary 格式，二者不能混用
真正麻烦的不是命令本身，而是 profile 文件的隐式依赖：它绑定源码路径、构建时的 GOPATH/GOPROXY 状态，以及测试是否实际执行了目标代码。一个 go test 命令里漏了 -covermode 参数，后面所有操作都白忙。
