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语言免费学习笔记(深入)”;
-
go tool cover -html=coverage.out -o coverage.html:生成带颜色高亮的交互式 HTML 页面 - 打开
coverage.html,绿色行表示已覆盖,红色表示未覆盖,灰色是空行或注释 - 点击左侧文件名可跳转到对应源码视图;右上角有“Toggle details”可展开/收起函数级覆盖率
- 如果提示
open /dev/tty: no such device or address,说明终端不支持直接打开浏览器,可手动用浏览器打开该 HTML 文件
导出为图表(简易版)
Go 原生命令不直接生成图表(如柱状图、趋势图),但可通过轻量方式对接常见工具:










