t.Run用于创建独立子测试以解决单测中用例耦合问题。它支持单独运行、过滤、并行执行及嵌套，常与表格驱动测试结合，提升可维护性与调试效率。
在Go语言中，t.Run 是 testing 包提供的一个强大功能，用于创建子测试（subtests）。它不仅让测试结构更清晰，还支持独立运行、过滤和并行执行。掌握 t.Run 的使用方式，对编写可维护的测试代码非常有帮助。
为什么需要子测试？
在写单元测试时，我们经常遇到一个函数需要测试多种输入情况。如果把所有情况写在一个测试函数里，会带来几个问题：
- 某个用例失败后，后续用例不再执行
- 无法单独运行某一条测试分支
- 错误定位困难，日志混杂
使用 t.Run 可以将每个测试场景拆分为独立的子测试，解决上述问题。
基本用法：t.Run 创建子测试
每个子测试通过 t.Run(name, func) 定义，name 是子测试名称，func 是测试逻辑。
立即学习“go语言免费学习笔记（深入）”；
func TestAdd(t *testing.T) {
t.Run("positive numbers", func(t *testing.T) {
result := add(2, 3)
if result != 5 {
t.Errorf("expected 5, got %d", result)
}
})
t.Run("negative numbers", func(t *testing.T) {
result := add(-1, -1)
if result != -2 {
t.Errorf("expected -2, got %d", result)
}
})
}
运行这个测试，输出会显示两个独立的子测试项。你可以用 go test -run TestAdd/positive 单独运行“positive numbers”这个子测试。
结合表格驱动测试（Table-Driven Tests）
子测试最常见的应用场景是配合表格驱动测试。这种方式能用统一结构覆盖多个测试用例。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
func TestValidateEmail(t *testing.T) {
tests := []struct {
name string
email string
isValid bool
}{
{"valid simple email", "user@example.com", true},
{"missing @", "userexample.com", false},
{"empty string", "", false},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
result := validateEmail(tt.email)
if result != tt.isValid {
t.Errorf("expected %v, got %v", tt.isValid, result)
}
})
}
}
每个测试用例作为一个子测试运行。即使其中一个失败，其他用例仍会继续执行。同时，你可以精准运行某条用例：
go test -run TestValidateEmail/valid_simple_email
子测试的高级特性
t.Run 不只是组织结构的工具，还支持一些实用功能：
- 独立生命周期：每个子测试有自己的 defer 和 cleanup 机制
- 并行执行：在子测试中调用 t.Parallel()，可与其他并行子测试同时运行
- 层级嵌套：t.Run 内部可以再调用 t.Run，形成多级测试树
例如，并行运行多个子测试：
t.Run("group", func(t *testing.T) {
t.Run("case 1", func(t *testing.T) {
t.Parallel()
// 测试逻辑
})
t.Run("case 2", func(t *testing.T) {
t.Parallel()
// 测试逻辑
})
})
这在 I/O 密集或耗时较长的测试中能显著提升效率。
基本上就这些。合理使用 t.Run 能让你的测试更清晰、易调试、可扩展。不复杂但容易忽略。
