t.Run用于Go测试中创建子测试,提升用例组织性与可读性。通过示例可见,它支持分组命名、独立运行及清晰输出,结合表驱动更高效。

在Go语言中,t.Run 是 *testing.T 类型的一个方法,用于创建子测试(subtests)。它让测试更具结构性,便于组织用例、隔离执行以及更清晰地输出结果。下面是一个使用 t.Run 实现子测试的实用示例。
基本结构:使用 t.Run 分组测试用例
假设我们有一个简单的函数,用于判断一个整数是否为偶数:
// even.go
package main
func IsEven(n int) bool {
return n%2 == 0
}接下来编写测试文件,并使用 t.Run 来组织多个测试用例:
// even_test.go
package main
import "testing"
func TestIsEven(t *testing.T) {
t.Run("even number", func(t *testing.T) {
if !IsEven(4) {
t.Error("expected 4 to be even")
}
})
t.Run("odd number", func(t *testing.T) {
if IsEven(3) {
t.Error("expected 3 not to be even")
}
})
t.Run("zero is even", func(t *testing.T) {
if !IsEven(0) {
t.Error("expected 0 to be even")
}
})
}运行测试并查看输出
在项目目录下运行:
立即学习“go语言免费学习笔记(深入)”;
go test -v输出类似:
=== RUN TestIsEven
=== RUN TestIsEven/even_number
=== RUN TestIsEven/odd_number
=== RUN TestIsEven/zero_is_even
--- PASS: TestIsEven (0.00s)
--- PASS: TestIsEven/even_number (0.00s)
--- PASS: TestIsEven/odd_number (0.00s)
--- PASS: TestIsEven/zero_is_even (0.00s)
PASS
ok example.com/even 0.001s可以看到每个子测试都有独立名称和运行结果,层级清晰。
优势与使用建议
-
结构清晰:通过命名子测试,可以清楚知道哪个具体场景失败
-
可单独运行:支持使用
-run=TestName/SubName 运行特定子测试,例如:
go test -v -run=TestIsEven/odd
-
便于参数化:结合表驱动测试更高效
下面是结合表驱动的写法示例:
func TestIsEven_TableDriven(t *testing.T) {
tests := []struct {
name string
input int
want bool
}{
{"even number", 4, true},
{"odd number", 3, false},
{"zero", 0, true},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
if got := IsEven(tt.input); got != tt.want {
t.Errorf("IsEven(%d) = %v; want %v", tt.input, got, tt.want)
}
})
}
}基本上就这些。t.Run 让测试更模块化,推荐在编写测试时积极使用。
以上就是Golang使用t.Run实现子测试示例的详细内容,更多请关注php中文网其它相关文章!