执行 go test -coverprofile=coverage.out ./server/ 生成覆盖率数据文件,再用 go tool cover -html=coverage.out -o coverage.html 生成可交互HTML报告,绿色为覆盖行、红色为未覆盖行,点击函数名可跳转定位。

直接用 go test -cover 就能拿到覆盖率数值,但要生成可交互的 HTML 报告,得两步走:先写入 profile 文件,再转成网页。
执行测试并生成 coverage.out 文件
在项目根目录(或 server/ 目录)下运行:
go test -coverprofile=coverage.out ./server/
注意几点:
-
./server/是你的后端代码所在包路径,替换成实际路径,比如./routers或./services - 如果测试失败,
-coverprofile仍会生成文件,但只覆盖已执行的分支;建议先确保go test能通过 - 默认只统计当前包,不递归子包;加
./...可包含所有子目录,但容易混入无关测试(如vendor或test目录),推荐显式指定
用 go tool cover 生成 HTML 报告
上一步生成的 coverage.out 是二进制 profile 数据,需用 Go 工具解析:
go tool cover -html=coverage.out -o coverage.html
执行后会输出 coverage.html,用浏览器打开即可看到带颜色标记的源码行——绿色是覆盖到的,红色是漏掉的。
- 报告里点击函数名,能跳转到具体文件和行号,方便定位未测逻辑
- 如果报错
no statements to track,说明目标包下没有*_test.go文件,或测试没命中任何代码行(比如路由注册了但没调用 handler) - HTML 报告默认不包含第三方依赖,只显示你 own 的代码
常见覆盖率偏低的真实原因
跑出来 30% 不是测试写得少,往往是结构问题卡住了:
- Handler 函数里直接操作数据库或调外部 API,没 mock,导致测试一跑就 panic 或超时,实际只执行了前几行
- 中间件逻辑写在
router.Use(...)里,但测试时只调router.ServeHTTP(),中间件根本没触发 - 错误处理分支(比如
if err != nil)永远走不到,因为 mock 返回值太“干净”,需要补一个返回 error 的 case - 使用了
gin.Default(),它自带Logger和Recovery中间件,可能干扰测试输出或 panic 捕获,建议测试中改用gin.New()+ 手动注册必要中间件
覆盖率数字本身不重要,重要的是每一行红色代码背后有没有被验证过的测试路径。别为了凑 80% 而写无效断言,重点盯住 if 分支、error 处理、参数校验这三类高风险区域。











