gocovmerge不能直接合并go test -coverprofile生成的文本或二进制coverage.out文件，因其仅支持json输入；需先用gocov convert转换格式，且注意go 1.20+兼容性问题。
gocovmerge 为什么不能直接合并 go test -coverprofile 生成的文件
因为 go test -coverprofile 输出的是「文本格式覆盖率 profile」（如 coverage.out），而 gocovmerge 只接受 JSON 格式的输入——它本质上是把多个 gocov 命令输出的 JSON 合并，不是直接读 .out 文件。
常见错误现象：gocovmerge: failed to unmarshal input: invalid character 'm' looking for beginning of value，这就是把二进制或 text profile 直接喂给了 gocovmerge。
- 必须先用
gocov把每个.out转成 JSON：gocov convert coverage1.out > coverage1.json -
gocov不是 Go 官方工具，需单独安装：go install github.com/axw/gocov/gocov@latest - 注意 Go 版本兼容性：Go 1.20+ 的
coverprofile格式有变更，gocov旧版本（v0.0.0-20160329091854-7e896b4f9d7e）可能解析失败；建议用较新 commit 或改用gocovmerge的替代方案（见下一条）
用 gotestsum + gocovreport 替代 gocovmerge 更稳
现在更推荐用 gotestsum 驱动测试、自动收集覆盖率，再用 gocovreport（或 gocov 自带的 report 子命令）合并和渲染——它绕过了 gocovmerge 对 JSON 输入的强依赖，也支持原生 .out 文件。
- 安装：
go install gotest.tools/gotestsum@latest和go install github.com/axw/gocov/gocov@latest - 单包测试并输出 profile：
gotestsum -- -coverprofile=unit.out -covermode=count - 多包并行测试并汇总：
gotestsum -- -coverprofile=coverage.out -covermode=count -coverpkg=./...（注意-coverpkg要显式指定，否则子包覆盖率不计入） - 合并多个
.out文件（需先转为 JSON）：gocov merge coverage1.out coverage2.out | gocov report—— 这条命令里gocov merge内部做了格式适配，比手动调gocovmerge更少出错
go tool cover -func 和 -html 输出结果不一致？
这是因 go tool cover 默认只统计「被编译进当前测试包的代码」，而 -coverpkg 指定的依赖包若含未被测试覆盖的函数，-func 会列出但标记为 0%，-html 却可能完全不显示——它默认过滤掉 0% 行。
立即学习“go语言免费学习笔记（深入）”；
- 确保所有待测包都参与编译：用
go test ./... -covermode=count -coverprofile=full.out -coverpkg=.（.表示当前模块所有包） - 生成完整 HTML 报告：
go tool cover -html=full.out -o coverage.html，此时会包含所有被-coverpkg引入的代码，哪怕未执行 - 如果仍缺文件，检查是否用了
//go:build ignore或构建 tag 排除了某些文件，cover不会处理它们
CI 中合并覆盖率时容易漏掉 vendor 或 internal 包
Go 的模块路径和包可见性会让 -coverpkg 行为变得隐晦。比如 internal/xxx 包默认不被外部引用，但测试时若没显式加到 -coverpkg 列表，它的覆盖率就永远不会出现在最终报告里。
- 不要只写
-coverpkg=.，而是明确列出：-coverpkg=github.com/your/repo/...,github.com/your/repo/internal/... -
vendor下的依赖默认不参与覆盖率统计；如需包含（极少见），得用-coverpkg显式加上 vendor 路径，并确保测试能 import 到那些包 - 用
go list -f '{{.ImportPath}}' ./...检查实际参与测试的包列表，再对照-coverpkg是否全覆盖
真正麻烦的不是合并动作本身，而是搞清哪些包该被覆盖、哪些被构建规则悄悄排除了——profile 文件里没数据，往往不是工具问题，是测试没真正触达那些代码。
