使用 t.Run 可结构化组织子测试，提升可读性和维护性。它支持清晰命名、独立运行子测试、避免变量污染，并便于共享 setup 与 teardown。结合表格驱动测试能高效覆盖多场景，通过 t.Parallel() 还可控制并发执行，是 Go 测试中推荐的最佳实践之一。
在 Go 中编写测试时，随着业务逻辑变复杂，测试用例也会增多。为了更好地组织和管理多个测试场景，t.Run 提供了一种清晰、结构化的方式来运行子测试（subtests）。它不仅让测试更易读，还能独立控制每个子测试的执行与结果。
为什么使用 t.Run？
直接写多个测试函数虽然可行，但当测试用例来自同一组输入或逻辑分支时，重复代码会增加维护成本。t.Run 允许你在单个测试函数内定义多个命名子测试，每个子测试可以有自己的 setup、assert 和 cleanup 逻辑。
使用 t.Run 的主要优势包括：
- 更好的测试分组和命名，输出更清晰
- 支持单独运行某个子测试（通过 go test -run=）
- 避免变量作用域污染，每个子测试有独立上下文
- setup 和 teardown 可复用
基本用法：t.Run 的结构
在测试函数中调用 t.Run(name, func) 来创建一个子测试。第一个参数是子测试名称，第二个是测试逻辑函数，接收 *testing.T。
func TestValidateEmail(t *testing.T) {t.Run("valid_email_returns_no_error", func(t *testing.T) {
err := ValidateEmail("user@example.com")
if err != nil {
t.Errorf("expected no error, got %v", err)
}
})
t.Run("empty_string_returns_error", func(t *testing.T) {
err := ValidateEm
ail("")if err == nil {
t.Error("expected error for empty email")
}
})
}
运行该测试后，输出会显示：
--- PASS: TestValidateEmail (0.00s)--- PASS: TestValidateEmail/valid_email_returns_no_error (0.00s)
--- PASS: TestValidateEmail/empty_string_returns_error (0.00s)
你可以通过命令只运行其中一个子测试：
go test -run TestValidateEmail/empty_string_returns_error共享 setup 与数据驱动测试
结合 t.Run 与表格驱动测试（table-driven tests），能高效覆盖多种输入场景。
func TestCalculateTax(t *testing.T) {cases := []struct {
name string
income float64
expected float64
}{
{"low_income", 10000, 1000},
{"high_income", 50000, 7500},
{"zero_income", 0, 0},
}
for _, tc := range cases {
tc := tc // 注意：捕获循环变量
t.Run(tc.name, func(t *testing.T) {
result := CalculateTax(tc.income)
if result != tc.expected {
t.Errorf("got %.2f, want %.2f", result, tc.expected)
}
})
}
}
这种模式特别适合验证函数对不同输入的响应。注意在循环中使用 tc := tc 是为了防止闭包共享变量问题。
子测试中的并发与控制
如果希望子测试并行执行，可以在父测试或子测试中调用 t.Parallel()。
t.Run("parallel_subtests", func(t *testing.T) {t.Parallel()
t.Run("a", func(t *testing.T) {
t.Parallel()
// 测试逻辑
})
t.Run("b", func(t *testing.T) {
t.Parallel()
// 测试逻辑
})
})
注意：只有标记了 t.Parallel() 的子测试才会与其他并行测试同时运行。未标记的仍按顺序执行。
基本上就这些。t.Run 让测试更具结构性，配合表格驱动模式，能显著提升测试可读性和可维护性。不复杂但容易忽略的是命名清晰和变量捕获问题，写的时候多留意即可。
