t.Run用于Go测试中创建子测试，提升用例组织性与可读性。通过示例可见，它支持分组命名、独立运行及清晰输出，结合表驱动更高效。
在Go语言中，t.Run 是 *testing.T 类型的一个方法，用于创建子测试（subtests）。它让测试更具结构性，便于组织用例、隔离执行以及更清晰地输出结果。下面是一个使用 t.Run 实现子测试的实用示例。
基本结构：使用 t.Run 分组测试用例
假设我们有一个简单的函数，用于判断一个整数是否为偶数：
// even.gopackage main
func IsEven(n int) bool {
return n%2 == 0
}
接下来编写测试文件，并使用 t.Run 来组织多个测试用例：
// even_test.gopackage 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语言免费学习笔记（深入）”；
bee餐饮点餐外卖小程序
下载
bee餐饮点餐外卖小程序是针对餐饮行业推出的一套完整的餐饮解决方案，实现了用户在线点餐下单、外卖、叫号排队、支付、配送等功能，完美的使餐饮行业更高效便捷！功能演示：1、桌号管理登录后台，左侧菜单 “桌号管理”，添加并管理你的桌号信息，添加以后在列表你将可以看到 ID 和 密钥，这两个数据用来生成桌子的二维码2、生成桌子二维码例如上面的ID为 308，密钥为 d3PiIY，那么现在去左侧菜单微信设置
输出类似：
=== 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 让测试更模块化，推荐在编写测试时积极使用。
