17370845950

go test 自带覆盖率功能，通过 -coverprofile 生成数据，用 go tool cover 转换为函数级摘要、HTML 报告或提取数值绘图，支持多包合并与 CI 集成。

Go 自带的 go test 工具就能生成覆盖率数据，无需额外安装插件。关键在于用对参数、正确合并多包数据，并借助简单工具转成 HTML 报告或图表。

用 go test -coverprofile 生成原始覆盖率文件

在项目根目录或待测包目录下运行：

• go test -coverprofile=coverage.out：生成当前包的覆盖率数据（文本格式）
• go test ./... -coverprofile=coverage.out：递归测试所有子包，但注意——这会覆盖前一个包的结果，只保留最后一个包的数据
• 要合并多个包的覆盖率，需分步生成再手动合并：先为每个包单独生成 cover_*.out，再用 go tool cover -func 或脚本合并

查看覆盖率摘要和函数级明细

生成 coverage.out 后，可快速检查结果：

• go tool cover -func=coverage.out：列出每个文件、每个函数的语句覆盖率（如 main.go:12.5,15.2 66.7%）
• go tool cover -func=coverage.out | grep "html\|total"：快速看 HTML 包或整体覆盖率
• 若输出中某函数显示 0.0%，通常是因为该函数未被任何测试调用，或包含不可达分支（如 panic 后的代码）

生成可视化 HTML 报告

这是最常用也最直观的方式：

• go tool cover -html=coverage.out -o coverage.html：生成带颜色高亮的交互式 HTML 页面
• 打开 coverage.html，绿色行表示已覆盖，红色表示未覆盖，灰色是空行或注释
• 点击左侧文件名可跳转到对应源码视图；右上角有“Toggle details”可展开/收起函数级覆盖率
• 如果提示 open /dev/tty: no such device or address，说明终端不支持直接打开浏览器，可手动用浏览器打开该 HTML 文件

导出为图表（简易版）

Go 原生命令不直接生成图表（如柱状图、趋势图），但可通过轻量方式对接常见工具：

• 提取覆盖率数值：go tool cover -func=coverage.out | tail -1 | awk '{print $3}' | sed 's/%//' 得到总覆盖率数字
• 配合 jq + gnuplot 或 Python 的 matplotlib，把多次运行的 coverage.out 转成趋势图（适合 CI 中长期追踪）
• CI 场景推荐：用 gcov2lcov 或 gocov 转成 lcov 格式，再用 Codecov 或本地 genhtml 渲染更丰富的报告（含分支覆盖率、历史对比）