go 的 `go test -cover` 默认仅统计同包内测试的覆盖率；若集成测试（如 http 端到端测试）位于独立包（如 `main`），需配合 `-coverpkg` 指定被测目标包，才能真实反映业务逻辑覆盖情况。
在 Go 中进行 REST API 集成测试时，常见做法是启动服务进程、发送 HTTP 请求并断言响应——这类测试通常放在 main_test.go 或独立测试包中（如 package main），不与被测业务逻辑同包。此时直接运行 go test -cover ./... 会严重高估覆盖率：它只统计测试文件所在包自身的语句执行情况，而真正承载核心逻辑的 mypackage（如 handler、service、repository 层）几乎不会被计入，导致报告中出现“0%”或极低值，完全失真。
正确方案是使用 -coverpkg 标志显式声明待分析的被测包。该标志告诉 go test：即使测试代码不在目标包内，也要追踪对指定包中代码的执行覆盖。语法如下：
go test -cover -coverpkg=mypackage ./... # 或更精确地限定测试目录（推荐） go test -cover -coverpkg=mypackage ./src/api/...
✅ 示例输出对比：
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
# ❌ 错误方式：未指定 coverpkg，仅统计测试包自身（如 main） $ go test -cover ./src/api/... ok /api 0.191s coverage: 71.0% of statements # 这是 main_test.go 的覆盖率，无意义 ok /api/mypackage 0.023s coverage: 0.7% of statements # ✅ 正确方式：聚焦业务包 mypackage $ go test -cover -coverpkg=mypackage ./src/api/... ok /api 0.190s coverage: 50.8% of statements in mypackage # 关键指标！ ok /api/mypackage 0.022s coverage: 0.7% of statements in mypackage
? 提示：-coverpkg 支持逗号分隔多个包（如 -coverpkg=mypackage,myutil），也支持通配符（如 -coverpkg=./...），但建议显式列出核心业务包，避免噪声干扰。
此外，为获得更完整的视图，可结合 -covermode=count 生成详细计数报告，并用 go tool cover 可视化：
# 生成覆盖数据文件 go test -cover -covermode=count -coverpkg=mypackage -coverprofile=coverage.out ./src/api/... # 生成 HTML 报告（打开浏览器查看具体哪行被覆盖） go tool cover -html=coverage.out -o coverage.html
⚠️ 注意事项：
- -coverpkg 必须与被测包路径完全一致（区分大小写，匹配 go list -f '{{.ImportPath}}' ./path/to/pkg 输出）；
- 若项目使用 Go Modules，请确保 GOPATH 和模块路径无冲突，优先在 module 根目录下执行命令；
- 集成测试本身应尽量轻量、可重复、无副作用（例如使用临时端口、内存数据库），避免因环境问题导致覆盖率波动；
- 单元测试仍不可替代：-coverpkg 能提升集成测试的覆盖率可信度，但细粒度逻辑分支、边界条件仍需单元测试保障。
最终，覆盖率只是质量佐证而非目标——50% 的精准 mypackage 覆盖率，远胜于 90% 的虚假 main 包覆盖率。聚焦业务包，让数据真正驱动测试完善。
