子测试必须在t.Run内部调用t.Helper()才能正确标记辅助函数；子测试名不可含斜杠，需用下划线或连字符替代；子测试共享父测试生命周期但有独立t实例；重复子测试名会导致运行时panic。
子测试必须在 t.Run 内部调用 t.Helper() 才能正确标记辅助函数
Go 的子测试本身不自动继承父测试的 helper 状态。如果你把断言逻辑抽成函数，在子测试里调用它，但没在该函数里显式调用 t.Helper()，失败时堆栈会指向子测试调用点，而不是实际出错的那行断言——这会让定位问题变困难。
常见错误写法：
func assertEqual(t *testing.T, got, want interface{}) {
if !reflect.DeepEqual(got, want) {
t.Fatalf("got %v, want %v", got, want) // 这里报错，但堆栈显示在 t.Run 里那行
}
}
正确做法是立刻在函数开头加 t.Helper()：
func assertEqual(t *testing.T, got, want interface{}) {
t.Helper() // 必须加！否则 t.Fatalf 的文件/行号指向错误
if !reflect.DeepEqual(got, want) {
t.Fatalf("got %v, want %v", got, want)
}
}
- 每个封装的测试辅助函数都应以
t.Helper()开头 - 子测试内部调用的函数，哪怕只有一层，也需单独标记
- 不加
t.Helper()不报错，但调试时会浪费大量时间看错堆栈
t.Run 的 name 参数不能含斜杠（/），否则会被当成嵌套子测试处理
Go 测试框架把 / 当作子测试层级分隔符。如果传入 "user/login"，go test 会把它解释为名为 "user" 的子测试下再嵌套一个 "login"，而实际你只想建一个扁平名字。
立即学习“go语言免费学习笔记（深入）”；
这会导致两个问题：
- 测试输出中出现意外缩进和嵌套结构
- 用
-run过滤时行为异常，比如go test -run=TestAPI/user可能匹配到你不想要的测试 - CI 工具或 IDE 解析测试树时可能误判层级
安全命名建议：
- 用下划线代替斜杠：
"user_login" - 用连字符：
"user-login" - 纯字母数字 + 下划线，避免任何路径感字符
子测试共享父测试的生命周期，但各自有独立的 t 实例和并发控制
所有子测试运行在同一个测试函数 goroutine 中，但每个子测试获得自己的 *testing.T 实例。这意味着：
- 子测试之间默认串行执行，除非显式调用
t.Parallel() - 父测试调用
t.Fatal会直接终止整个测试函数，包括尚未开始的子测试 - 子测试调用
t.Fatal只终止自己，不影响其他子测试运行 - 子测试里修改全局变量、临时文件、数据库连接等资源，需自行保证隔离性
并发执行示例（注意：只有加了 t.Parallel() 才真正并发）：
func TestCalc(t *testing.T) {
for _, tc := range []struct{
name string
a, b int
want int
}{
{"add", 2, 3, 5},
{"sub", 5, 2, 3},
} {
tc := tc // 必须捕获循环变量
t.Run(tc.name, func(t *testing.T) {
t.Parallel() // 这行才开启并发
if got := calc(tc.a, tc.b); got != tc.want {
t.Errorf("got %d, want %d", got, tc.want)
}
})
}
}
子测试名重复会导致 panic，且不会被 go test 自动检测
同一父测试内，若多个 t.Run 传入相同 name，运行时会 panic 并输出类似：
testing: test TestXxx failed: t.Run: duplicate test name "xxx"
这个问题常出现在动态生成子测试名的场景，比如遍历 map 或未重置的计数器：
- map 遍历时 key 顺序不确定，若用
fmt.Sprintf("case_%d", i)但i没随每次迭代更新，就会重复 - 用字符串拼接但忽略空格、大小写、特殊字符归一化（如
"foo"和"Foo"在某些系统里被误认为相同） - 测试数据来自外部 JSON，字段名含不可见 Unicode 字符
预防方式：
- 打印所有子测试名做校验：
t.Log("running:", name) - 用
strings.ReplaceAll(name, " ", "_")统一空白符 - 对生成的名字做哈希后截取，或加序号后缀确保唯一
子测试的命名自由度高，但唯一性是硬约束；它不像包级测试名那样由编译器管理，全靠人写对。
