Go / 系统课时
分析测试覆盖率
分析测试覆盖率
本节用一个故意漏测零值路径的 Go 包生成覆盖率 profile、函数摘要和 HTML 报告,再据此判断哪些业务分支值得补测。重点不是把数字刷到 100%,而是把覆盖率当作寻找测试盲区的线索。
学习目标
- 使用
go test -coverprofile生成可复用的覆盖率数据。 - 使用
go tool cover定位未执行的语句块,并把结果转换为补测决策。 - 区分“覆盖率高”和“关键行为被验证”这两个不同目标。
从一份可复现的覆盖率结果开始
下面的 Bash 示例会创建一个临时 Go 模块。Classify 有负数、零值、正数三个路径,但测试故意只覆盖负数和正数,以便制造一个真实的覆盖率缺口。
set -eu
tmp_dir="$(mktemp -d)"
trap 'rm -rf "$tmp_dir"' EXIT
cd "$tmp_dir"
go mod init example.com/coverage >/dev/null 2>&1
# 被测函数保留三个互斥路径。
cat > classify.go <<'EOF'
package coverage
func Classify(n int) string {
if n < 0 {
return "negative"
}
if n == 0 {
return "zero"
}
return "positive"
}
EOF
# 测试只覆盖负数和正数,故意漏掉零值路径。
cat > classify_test.go <<'EOF'
package coverage
import "testing"
func TestClassify(t *testing.T) {
tests := []struct {
name string
in int
want string
}{
{name: "negative", in: -1, want: "negative"},
{name: "positive", in: 1, want: "positive"},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
if got := Classify(tt.in); got != tt.want {
t.Fatalf("Classify(%d) = %q, want %q", tt.in, got, tt.want)
}
})
}
}
EOF
# 同一份 profile 同时用于摘要和 HTML 定位。
go test -coverprofile=coverage.out ./...
go tool cover -func=coverage.out
go tool cover -html=coverage.out -o coverage.html预期输出
ok example.com/coverage <TIME>s coverage: 80.0% of statements
example.com/coverage/classify.go:3: Classify 80.0%
total: (statements) 80.0%<TIME> 会随机器和 Go 版本变化。最后一个命令成功时通常不打印额外文本,而是在当前目录生成 coverage.html。
读懂三种覆盖率视图
go test -coverprofile=coverage.out 一边运行测试,一边记录哪些语句块被执行。终端里的 80.0% of statements 是整体摘要,适合快速观察变化,但不能告诉你缺口在哪里。
go tool cover -func=coverage.out 把同一份 profile 汇总到函数级别。本例只有一个函数,所以可以立即确认缺口就在 Classify。项目更大时,应优先查看业务核心包和近期修改函数,而不是只盯全仓库总百分比。
go tool cover -html=coverage.out -o coverage.html 会把命中状态映射回源码。打开该文件后,可以看到 n == 0 对应的返回语句没有被执行,这比单独看到“80%”更有行动价值。
把未覆盖代码转成测试决策
覆盖率告诉你“哪里没有执行”,但不会替你判断“那里是否值得测试”。本例中的零值路径定义了明确业务语义,因此应该在 tests 切片中加入 {name: "zero", in: 0, want: "zero"},再重新运行覆盖率检查。
go test -cover ./...预期输出
ok example.com/coverage <TIME>s coverage: 100.0% of statements这次达到 100% 是因为示例很小,不代表真实项目也应追求同样数字。更合理的做法是优先补齐错误处理、边界值、权限判断、状态转换等“漏测后代价高”的路径。
不把百分比当成质量结论
Go 的基础覆盖率主要回答语句块是否被执行,它不是完整的分支组合证明。即使显示 100%,断言写错、输入空间过窄、并发时序未覆盖,测试仍可能漏掉缺陷;复杂条件表达式也可能在语句已命中的情况下缺少关键组合。
持续测试中可以设置覆盖率下限来防止明显倒退,但门禁应与代码评审一起使用。真正有价值的检查顺序是:先找到未覆盖区域,再判断其业务风险,最后为高风险行为补上能失败、能定位、能长期维护的测试。