go test -coverprofile 生成文本格式覆盖率文件（如coverage.out），需配合 go tool cover 解析为html报告；必须在原路径运行，-covermode=count 记录执行次数，./... 统一覆盖子包，避免拼接二进制profile。
用 go test -coverprofile 生成覆盖率数据文件
Go 原生支持覆盖率统计，核心是 go test 的 -coverprofile 参数。它不直接输出报告，而是生成一个文本格式的覆盖率 profile 文件（如 coverage.out），后续用 go tool cover 解析。
常见错误是只加 -cover：它只在终端打印一行 summary（如 coverage: 65.2% of statements），无法生成可交互的 HTML 报告。
- 生成 profile 文件：运行
go test -coverprofile=coverage.out ./...（./...表示当前模块下所有子包） - 若只想测某个包，替换为
go test -coverprofile=coverage.out ./pkg/http - 想包含测试中调用的依赖包（非被测包本身），需加
-covermode=count（默认set模式只记是否执行过；count记执行次数，对分支/性能分析更有用）
用 go tool cover -html 查看可视化报告
有了 coverage.out，就能生成带高亮、可跳转的 HTML 报告：
go tool cover -html=coverage.out -o coverage.html
打开 coverage.html 即可见整体覆盖率和每个文件的行级覆盖详情——未执行的代码行会标红，执行过的标绿，执行多次的标黄。
立即学习“go语言免费学习笔记（深入）”；
- 注意：
go tool cover只能解析本机生成的 profile，且要求源码路径与 profile 中记录的路径一致（比如在 GOPATH 或 module 根目录下运行命令） - 如果报错
open xxx.go: no such file or directory，说明 profile 记录的是绝对路径，但你当前不在原路径下运行；此时应回到生成 profile 的目录再执行go tool cover -
-html不支持直接指定端口或启动服务器，如需实时预览，可用 Python 快速起服务：python3 -m http.server 8000，然后访问http://localhost:8000/coverage.html
合并多个包的覆盖率数据
当项目有多个子包，且你想得到整个模块的总覆盖率（而非每个包单独跑出来的结果），不能简单地对各 coverage.out 文件做 cat 拼接——Go 的 profile 是二进制格式，直接拼会损坏。
本文档主要讲述的是maven使用方法；Maven是基于项目对象模型的（pom），可以通过一小段描述信息来管理项目的构建，报告和文档的软件项目管理工具。Maven将你的注意力从昨夜基层转移到项目管理层。Maven项目已经能够知道 如何构建和捆绑代码，运行测试，生成文档并宿主项目网页。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
正确做法是用 go tool cover -func 提取各文件的覆盖率摘要，再手动汇总；但更实用的是用第三方工具 gocov 或 gotestsum。不过 Go 1.21+ 已内置支持多包合并：
go test -coverprofile=coverage.out -covermode=count ./... && go tool cover -func=coverage.out
这会输出所有函数的覆盖率明细，可用于计算加权平均。若坚持要单个 HTML 报告，目前最稳的方式仍是：确保所有测试在模块根目录下统一运行，用 ./... 一次覆盖全部。
- CI 场景中常误将不同子目录的
go test分开执行，导致无法合并；应统一用模块根路径 +./... -
-covermode=count生成的 profile 更大，但能暴露“看似覆盖实则只走了一条分支”的问题（比如 if/else 中只测了 if）
忽略测试文件或特定函数
Go 的覆盖率默认包含所有 .go 文件，包括 *_test.go。但测试文件里的逻辑（如 test helper 函数）通常不该计入覆盖率目标。解决方法是在测试文件顶部加注释标记：
//go:build ignore_cover
不过该标记需配合构建约束使用，实际更常用的是在生成 profile 时排除测试文件——但 go test 本身不提供 exclude 选项。
折中方案：用 go list 动态获取非测试包列表：
go list ./... | grep -v '_test$' | xargs go test -coverprofile=coverage.out -covermode=count
更彻底的做法是，在 CI 脚本里用 find 过滤掉 *_test.go 所在目录，或借助 gocovmerge 工具后处理 profile。
- 别试图用
//go:nocover标记函数——它只在 Go 1.20+ 支持，且仅对语句级生效，不适用于整个文件 - 真正难处理的是自动生成的 mock 文件或 protobuf 生成代码；这类应从覆盖率目标中剔除，而不是硬塞进报告里拉低数字
