t.Run是go内置子测试入口，支持共享setup/teardown、层级命名、按名筛选、table-driven测试及单个失败不中断整体执行；需注意命名规范、闭包变量捕获、t.Parallel()必须首行调用。
t.Run 是 Go 原生支持子测试的唯一入口，不需要引入 Testify 或其他第三方库——它从 Go 1.7 就已内置在 testing 包中。
为什么用 t.Run 而不是写多个 TestXxx 函数？
核心好处是共享 setup/teardown 逻辑，避免重复初始化（比如打开数据库、创建临时目录、设置环境变量）。多个独立测试函数会各自执行一遍 setup，而子测试可把共用逻辑提至父测试函数开头和结尾。
- 子测试失败时，错误路径带层级名（如
TestCalc/Add/positive_numbers），定位更准 - 支持按名称筛选运行：
go test -run "TestCalc/Add"或go test -run "positive"（模糊匹配） - 便于做 table-driven 测试，结构清晰、增删用例不改主干逻辑
- 单个子测试 panic 不会中断整个
TestXxx，其他子测试仍继续执行
t.Run 的参数和执行行为必须清楚
t.Run(name String, f func(t *testing.T)) bool 中，name 是纯字符串，不能含 /（否则会被解析为嵌套层级，但实际不推荐手动拼接层级名）；f 是闭包函数，注意变量捕获陷阱。
- 默认串行执行：三个
t.Run按代码顺序依次阻塞运行，不会并发 - 想并发？必须在子测试函数内部第一行调用
t.Parallel()，否则无效 - 闭包中若引用循环变量（如
for _, tc := range cases），要传参或显式拷贝，否则所有子测试看到的是最后一个值 -
t.Run返回bool表示子测试是否通过，但极少需要检查——失败会自动标记父测试为 fail
func TestAdd(t *testing.T) { cases := []struct{ a, b, want int }{ {1, 2, 3}, {0, 0, 0}, {-1, 1, 0}, } for _, tc := range cases { tc := tc // ⚠️ 必须显式拷贝，否则闭包捕获的是循环变量地址 t.Run(fmt.Sprintf("Add(%d,%d)", tc.a, tc.b), func(t *testing.T) { t.Parallel() // ✅ 放这里才生效 if got := Add(tc.a, tc.b); got != tc.want { t.Errorf("got %d, want %d", got, tc.want) } }) } }子测试命名不是随便起的，影响可维护性
名字是调试时的第一眼信息，也是 -run 筛选的依据。建议采用「动词+输入特征」格式，避免模糊词如 "case1" 或 "test1"。
- 好名字：
"Add/positive_numbers"、"ParsejsON/empty_string"、"HTTPHandler/404_not_found" - 坏名字：
"A"、"test_01"、"check1" - 层级名由
t.Run自动拼接，父测试名 +/+ 子测试名，所以子测试名本身不要带斜杠（除非你真要三级嵌套） - 名字里不要含空格或特殊符号，否则
go test -run可能无法匹配
子测试不是语法糖，它是 Go 测试组织的基础设施级能力。真正容易被忽略的是：子测试内调用 t.Parallel() 必须放在函数体第一行，晚于任何其他语句（包括 defer）都会导致并发不生效——这个限制没有报错，只默默退化为串行，极难排查。