Go / 系统课时

分析测试覆盖率

分析测试覆盖率

本节用一个故意漏测零值路径的 Go 包生成覆盖率 profile、函数摘要和 HTML 报告,再据此判断哪些业务分支值得补测。重点不是把数字刷到 100%,而是把覆盖率当作寻找测试盲区的线索。

学习目标

  • 使用 go test -coverprofile 生成可复用的覆盖率数据。
  • 使用 go tool cover 定位未执行的语句块,并把结果转换为补测决策。
  • 区分“覆盖率高”和“关键行为被验证”这两个不同目标。

从一份可复现的覆盖率结果开始

下面的 Bash 示例会创建一个临时 Go 模块。Classify 有负数、零值、正数三个路径,但测试故意只覆盖负数和正数,以便制造一个真实的覆盖率缺口。

bash
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

预期输出

text
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"},再重新运行覆盖率检查。

bash
go test -cover ./...

预期输出

text
ok  	example.com/coverage	<TIME>s	coverage: 100.0% of statements

这次达到 100% 是因为示例很小,不代表真实项目也应追求同样数字。更合理的做法是优先补齐错误处理、边界值、权限判断、状态转换等“漏测后代价高”的路径。

不把百分比当成质量结论

Go 的基础覆盖率主要回答语句块是否被执行,它不是完整的分支组合证明。即使显示 100%,断言写错、输入空间过窄、并发时序未覆盖,测试仍可能漏掉缺陷;复杂条件表达式也可能在语句已命中的情况下缺少关键组合。

持续测试中可以设置覆盖率下限来防止明显倒退,但门禁应与代码评审一起使用。真正有价值的检查顺序是:先找到未覆盖区域,再判断其业务风险,最后为高风险行为补上能失败、能定位、能长期维护的测试。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

分析测试覆盖率

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通