subtest是Go中通过t.Run()创建的子测试，用于分组测试用例、提升可读性和调试效率。它支持并行执行、共享setup、动态命名和单独运行，常与表格驱动结合，使测试结构清晰、易扩展。
在 Go 语言的测试中，使用 subtest（子测试）可以将一个测试函数拆分为多个逻辑子测试，尤其适合对同一函数的不同输入场景进行分组测试。它不仅让测试结构更清晰，还能单独运行某个子测试，提升调试效率。
什么是 subtest
subtest 是 *testing.T 类型提供的方法，通过 t.Run() 创建。每个子测试独立运行，有自己的名称和生命周期，支持并行执行、条件跳过和错误报告。
常见用途包括：
- 对同一函数测试多种输入组合
- 按功能模块或业务场景分组测试用例
- 复用 setup/teardown 逻辑
基本用法：t.Run()
下面是一个使用 subtest 测试字符串比较函数的例子：
立即学习“go语言免费学习笔记（深入）”；
func TestEqual(t *testing.T) {t.Run("same strings", func(t *testing.T) {
if !strings.Equal("hello", "hello") {
t.Error("expected hello == hello")
}
})
t.Run("different strings", func(t *testing.T) {
if strings.Equal("hello", "world") {
t.Error("expected hello != world")
}
})
}
运行结果会显示为：
--- PASS: TestEqual (0.00s)
--- PASS: TestEqual/same_strings (0.00s)
--- PASS: TestEqual/different_strings (0.00s)
使用表格驱动 + subtest 分组
结合表格驱动测试（table-driven test）可以让用例管理更高效。每个表项生成一个 subtest，便于定位失败用例。
func TestValidateEmail(t *testing.T) {tests := []struct {
name string
email string
valid bool
}{
{"valid gmail", "user@gmail.com", true},
{"invalid domain", "user@bad-domain", false},
{"empty", "", false},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
result := ValidateEmail(tt.email)
if result != tt.valid {
t.Errorf("expected %v, got %v", tt.valid, result)
}
})
}
}
这种写法清晰、易扩展，每个测试用例独立命名，输出信息明确。
subtest 的实用技巧
利用 subtest 可以实现一些高级控制：
- 并行执行：在子测试中调用 t.Parallel()，可让多个 subtest 并发运行，加快测试速度
- 共享 setup：在外部测试函数中执行公共初始化，如数据库连接、配置加载
- 动态命名：subtest 名称支持斜杠 "/"，自动形成层级结构，例如 "MySQL/insert" 和 "PostgreSQL/insert"
- 单独运行：使用命令 go test -run TestName/SubTestName 运行指定子测试
基本上就这些。subtest 让 Go 的测试更具组织性和可维护性，特别适合复杂逻辑或多场景验证。合理使用，能让测试代码更干净、调试更高效。
