go test -cover 仅显示覆盖率数字,需用 go tool cover -html 生成HTML查看红色未执行行,结合 -func 定位低覆盖函数;error分支常因未mock错误场景而遗漏,应使用表格驱动测试+依赖注入精准覆盖各类路径。

go test -cover 只是告诉你“覆盖率数字”,但真正卡住人的,是不知道哪行没跑、为什么没跑、补什么测试才有效。
怎么看清哪行代码根本没执行
go test -coverprofile=coverage.out 生成原始数据后,别只看终端百分比。立刻用 go tool cover -html=coverage.out -o coverage.html 打开网页——红色高亮的那几行,就是你必须补测试的地方。
- 红色不一定是“漏写了测试”,可能是逻辑上永远走不到(比如
if false { ... }),也可能是分支条件太难触发(比如err != nil但 mock 没返回错误) -
go tool cover -func=coverage.out能快速定位到具体哪个函数覆盖率低,比扫全量 HTML 更快 - 如果某函数显示 100%,但里面有个
log.Fatal永远没进,说明你只测了 happy path,error 分支压根没触发
为什么 error 分支总被漏掉
Go 里大量逻辑藏在 if err != nil 后面,但多数测试只传合法参数、连数据库都用真实连接跑通就完事。
- 对返回
error的接口调用,必须显式 mock 出错场景:比如用mock.On("Get").Return(nil, errors.New("timeout")) - 别依赖“运气”让外部服务失败;用
testify/mock或gomock控制返回值 -
context.Cancel和context.DeadlineExceeded这类错误要单独构造:传入已 cancel 的ctx,而不是等time.Sleep等超时(不稳定还慢)
表格驱动测试不是为了炫技,是为覆盖组合分支
一个带两个 if 的函数,至少有 4 种路径。手写 4 个 TestXxx 函数既重复又难维护。
- 把输入、期望 error、期望返回值打包成 struct 切片,用
t.Run驱动 - 特别注意边界:空字符串、
nil切片、负数 ID、超长字段——这些常触发不同分支 - 示例中
ValidateEmail测试了""和"abc.com",就是为了击中len(s) == 0和strings.Contains(s, "@") == false两条不同路径
mock 文件和依赖注入不光为解耦,是为精准控制执行流
直接在函数里调 db.QueryRow 或 http.Get,等于把测试绑死在环境上——你永远没法让那个 if err != nil 成立,除非真断网或删表。
- 提取接口:比如
type DB interface { QueryRow(...),然后函数接收该接口而非具体实现 - 在测试中传入 mock 实例,让它按需返回
nil,error, 或特定数据 - 每个 mock 方法调用后加
mock.AssertExpectations(t),防止你忘了设期望却误以为测试通过
真正卡住覆盖率提升的,从来不是工具不会用,而是没意识到:未覆盖的那行代码,往往对应着一个你没想清楚的执行路径,或者一个你不敢/懒得模拟的失败场景。


















