在Go语言的测试实践中，随着业务逻辑变复杂，单个测试函数往往需要覆盖多种输入组合与边界情况。如果把这些场景全部堆砌在一条直线式的断言里，一旦失败，我们很难快速判断是哪一组数据触发的错误。Go标准库中的testing包从1.7版本开始引入了子测试机制，通过t.Run方法可以在一个测试函数内部启动多个具备独立名称和生命周期的测试单元，从而让报错信息更精准、用例组织更灵活。
使用t.Run创建基础子测试
子测试的核心就是testing.T类型的Run方法，它的函数签名是func (t *T) Run(name string, f func(t *T)) bool。第一个参数是子测试的名称，第二个参数是一个接收子测试专属*testing.T的匿名函数。当外层测试函数被go test执行时，内部每一个t.Run调用都会生成一个独立的测试上下文，父测试会等待所有子测试完成后才结束。
下面示例展示如何用子测试分别验证整数加法在不同输入下的结果。每个子测试名称描述了场景，失败时命令行会明确打印类似--- FAIL: TestAdd/negative_numbers的层级路径，让定位更轻松。
package main
import "testing"
func Add(a, b int) int {
return a + b
}
func TestAdd(t *testing.T) {
t.Run("positive_numbers", func(t *testing.T) {
if Add(1, 2) != 3 {
t.Fatal("expected 3")
}
})
t.Run("negative_numbers", func(t *testing.T) {
if Add(-1, -2) != -3 {
t.Fatal("expected -3")
}
})
t.Run("zero_case", func(t *testing.T) {
if Add(0, 0) != 0 {
t.Fatal("expected 0")
}
})
}
从上面代码可以看出，子测试并不会增加额外的测试文件或函数声明成本。由于每个子测试拥有自己的*testing.T，在其中调用t.Fatal只会终止当前子测试，不会影响同级的其他子测试继续执行。这一点比自行用if分支判断后整个函数返回要友好得多，因为我们能在一次运行里看到所有失败分组而非遇到第一个错误就中断。
结合表驱动测试与子测试筛选
Go社区最常见的测试写法是表驱动测试，也就是把多组输入输出放在一个切片里循环断言。把表驱动和t.Run结合起来，既能保留数据集中定义的优势，又能获得子测试的可定位性。我们通常把切片里每项的名称字段作为t.Run的第一个参数，这样命令行输出的失败路径会自动带上用例名。
在排查问题时，我们常常只想跑某一个子测试。Go的go test命令提供了-run参数，它接受正则表达式并匹配测试及子测试的全路径。例如执行go test -run 'TestCalc/divide_by_zero'就只会运行名为divide_by_zero的那个子测试，大幅缩短反馈周期。下面代码演示表驱动配合子测试的写法：
package main
import "testing"
func Calc(a, b int) int {
return a / b
}
func TestCalc(t *testing.T) {
cases := []struct {
name string
a int
b int
want int
}{
{"normal", 10, 2, 5},
{"negative", -9, 3, -3},
{"divide_by_zero", 1, 0, 0},
}
for _, c := range cases {
t.Run(c.name, func(t *testing.T) {
got := Calc(c.a, c.b)
if got != c.want {
t.Errorf("Calc(%d,%d)=%d; want %d", c.a, c.b, got, c.want)
}
})
}
}
需要注意的是，当子测试名称里包含空格或特殊正则符号时，在命令行用-run筛选要用双引号包裹并转义，否则正则可能匹配异常。另外，如果表驱动循环变量直接在闭包里引用而没有重新赋值，在并行子测试中会产生经典的变量捕获bug，后文会说明如何规避。善用-run不仅能调试，还能在CI里按模块执行不同测试集，提升流水线效率。
子测试的并行控制与嵌套结构
当用例之间没有依赖且希望缩短总执行时间，可以调用t.Parallel让子测试并发运行。但必须注意，t.Parallel应该写在子测试函数内部，且父测试在调用t.Run之后默认会等待子测试结束；如果子测试调用了Parallel，它会暂停并让出给父测试，父测试结束后再并发执行所有标记为并行的子测试。下面示例展示并行写法及循环变量捕获的正确处理方式：
package main
import "testing"
import "time"
func TestParallel(t *testing.T) {
tests := []struct {
name string
n int
}{
{"one", 1},
{"two", 2},
{"three", 3},
}
for _, tc := range tests {
tc := tc
t.Run(tc.name, func(t *testing.T) {
t.Parallel()
time.Sleep(time.Duration(tc.n) * time.Millisecond)
if tc.n < 0 {
t.Fatal("unexpected")
}
})
}
}
除了平级子测试，t.Run也支持嵌套，也就是在子测试里再调用t.Run生成孙测试。这种层级结构适合表达复杂业务流，比如先测登录再测权限再测数据读写，每一层都能单独筛选。嵌套时命令行路径会变成TestA/level1/level2样式，非常直观。不过嵌套过深会导致名称冗长，建议控制在三层以内以保持可读。
在基准测试testing.B中同样可以使用b.Run创建子基准，用法和t.Run几乎一致，只是函数接收*testing.B。子基准让我们可以在同一基准函数里对比不同算法或参数的性能，而-bench参数也支持用正则筛选具体子基准。掌握这些技巧后，Go项目的测试代码会从扁平难读演进为结构清晰、可维护、可局部执行的工程化形态。