使用 t.Run 可为测试用例命名并独立运行,便于定位错误。它支持子测试层级结构,结合表格驱动测试能清晰组织多个场景,提升可维护性,是 Go 测试的标准实践。
在 Go 语言的测试中,t.Run 是 *testing.T 提供的一个方法,用来创建子测试(subtests)。它不仅能更好地组织测试用例,还能提高错误定位效率,尤其适合对同一函数的不同输入场景进行测试。
为什么要用 t.Run
不使用 t.Run 时,多个测试场景写在一起,一旦某个 case 失败,你只能知道整个测试函数失败了,但不清楚是哪个输入导致的。使用 t.Run 可以为每个测试用例命名,独立运行并输出结果,结构更清晰。
基本用法:用 t.Run 分组测试用例
下面是一个简单的例子,测试一个判断是否为偶数的函数:
func IsEven(n int) bool {
return n%2 == 0
}
func TestIsEven(t *testing.T) {
t.Run(“even_number_2”, func(t *testing.T) {
if !IsEven(2) {
t.Error(“2 should be even”)
}
})
t.Run(“odd_number_3”, func(t *testing.T) {
if IsEven(3) {
t.Error(“3 should not be even”)
}
})
t.Run(“negative_even_number”, func(t *testing.T) {
if !IsEven(-4) {
t.Error(“-4 should be even”)
}
})
}
执行测试:
立即学习“go语言免费学习笔记(深入)”;
go test -v
输出会显示每个子测试的名称和结果,便于排查问题。
使用表格驱动测试 + t.Run 提高效率
更常见的做法是结合表格驱动测试(table-driven test),用循环生成多个子测试:
func TestIsEven_TableDriven(t *testing.T) {
tests := []Struct {
name String
input int
want bool
}{
{“2_is_even”, 2, true},
{“3_is_odd”, 3, false},
{“-4_is_even”, -4, true},
{“0_is_even”, 0, true},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
got := IsEven(tt.input)
if got != tt.want {
t.Errorf(“IsEven(%d) = %v; want %v”, tt.input, got, tt.want)
}
})
}
}
这种写法结构清晰、扩展方便,新增测试用例只需在切片中添加一项。
子测试的额外优势
t.Run 不只是命名测试,它还支持:
- 独立失败不影响其他用例:一个子测试失败,其余仍会执行。
- 可单独运行某个子测试:使用 -run 标志,例如:
go test -run TestIsEven/2_is_even - 层级组织:t.Run 可嵌套,实现更复杂的测试结构(虽然一般不建议太深嵌套)。
基本上就这些。用好 t.Run 能让你的 Go 测试更清晰、易维护,特别是在写表格驱动测试时,几乎是标准做法。