17370845950

子测试必须在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"，而实际你只想建一个扁平名字。

这会导致两个问题：

• 测试输出中出现意外缩进和嵌套结构
• 用 -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, " ", "_") 统一空白符
• 对生成的名字做哈希后截取，或加序号后缀确保唯一

子测试的命名自由度高，但唯一性是硬约束；它不像包级测试名那样由编译器管理，全靠人写对。