t.Run 是 Go 1.7 引入的子测试核心机制,支持可组织、并行、独立执行的测试;需在顶层测试中调用 t.Run(name, func(t *testing.T)) 定义,子测试间隔离,支持按名运行、并行与层级分组。

Go 1.7 引入的 t.Run 是编写可组织、可并行、可独立执行的子测试(subtest)的核心方式,它让测试更清晰、易维护,也便于按名称过滤运行特定用例。
子测试的基本结构和写法
子测试必须在顶层测试函数内通过 t.Run(name, func(t *testing.T)) 定义。每个子测试拥有独立的 *testing.T 实例,彼此隔离:失败、跳过、并发控制互不影响。
- 子测试名应具描述性,推荐用小写字母+下划线,如
"empty_slice"、"with_negative_number" - 子测试函数体里仍用
t.Error、t.Fatal等方法,不可跨子测试复用外部t - 顶层测试函数本身不执行逻辑,只负责“注册”子测试
支持并行执行与资源清理
子测试默认串行执行;调用 t.Parallel() 可启用并行,但需确保测试间无共享状态或竞态。
- 仅在子测试函数开头调用
t.Parallel()才生效 - 若需共用初始化逻辑(如启动 mock server),放在
t.Run外;若需每子测试独有资源,放在子测试函数内,并搭配defer清理 - 示例:多个 HTTP handler 测试可并行,但共用一个 test DB 连接时需加锁或改用独立实例
按名称运行子测试与调试技巧
使用 go test -run="TestName/SubName" 可精准运行某子测试,大幅提升调试效率。
立即学习“go语言免费学习笔记(深入)”;
- 支持通配符,如
-run="TestParse/float.*"匹配所有以float开头的子测试名 - 子测试名支持层级,如
"json/marshal"和"json/unmarshal"会自动归组显示 - 结合
-v参数可看到每个子测试的开始/结束日志,便于定位卡点
避免常见陷阱
子测试看似简单,但几个细节容易出错:
- 闭包变量捕获:循环中创建子测试时,别直接引用循环变量(如
for _, tc := range cases { t.Run(tc.Name, ...)),应显式传参或复制值 - 顶层
t.Fatal会终止整个测试函数,导致后续子测试不运行;子测试内用t.Fatal只影响当前子测试 - 子测试不能嵌套定义(即不能在
t.Run的函数体内再调t.Run),Go 不支持递归子测试
基本上就这些。用好 t.Run 能让 Go 测试从“能跑”走向“好读、好调、好扩”。










