Go 测试子测试名称重复导致结果难读怎么办

如果多个 t.Run 传入相同名称，Go 不会让测试失去唯一性，而是自动在后续名称上追加序号，例如 TestConfig/cache 和 TestConfig/cache#01。问题在于这个编号只解决了框架层面的区分，失败日志仍然看不出是哪一组输入出了问题。更稳妥的做法是把用例编号、输入类型或边界条件放进名称，再保留业务标签。

重复的 t.Run 名称到底发生了什么

先看一个最小场景。两个用例都叫 cache，其中第二个故意失败：

func TestConfig(t *testing.T) {
    // 两个子测试使用同一个业务标签，观察名称如何被框架区分。
    t.Run("cache", func(t *testing.T) {
        t.Log("读取本地缓存配置")
    })
    t.Run("cache", func(t *testing.T) {
        // 这里的失败日志只能凭自动编号判断是哪一次调用。
        t.Fatalf("缓存过期时间不符合预期")
    })
}

运行 go test -run 'TestConfig/cache' -v 时，两次调用都可能被筛中，因为它们共享同一个路径片段。自动后缀通常能让测试名唯一，却不能告诉你第一个 cache 代表默认配置，还是代表 Redis 配置。这个差别就是“可执行”和“可维护”的分界。

用完整测试名和 -run 找到真正的失败用例

testing.T.Name() 返回当前子测试的完整路径。父测试名、子测试名和自动后缀会共同组成定位线索，所以可以先把名称打印到错误上下文，确认筛选表达式实际命中了哪些节点。

排查时重点看三件事：名称是否包含输入来源，失败信息是否包含期望边界，-run 是否可以缩小到一个稳定分支。名称过短时，终端里只能看到 #01；名称包含随机数时，CI 重跑又无法复用同一条筛选命令。

用稳定字段生成可读的表格测试名称

不要在循环里手写一组容易重复的固定字符串。把名称当作测试数据的一部分，使用稳定 ID 和可读标签组合即可：

func TestConfig(t *testing.T) {
    cases := []struct {
        id   int
        name string
        want int
    }{
        {id: 1, name: "default", want: 300},
        {id: 2, name: "expired", want: 0},
    }

    for _, tc := range cases {
        tc := tc // 兼容旧版本 Go 的循环变量捕获习惯。
        testName := fmt.Sprintf("%02d-%s", tc.id, tc.name)
        t.Run(testName, func(t *testing.T) {
            // 失败信息补充输入和期望值，便于 CI 日志脱离上下文阅读。
            got := readTTL(tc.name)
            if got != tc.want {
                t.Fatalf("name=%q got=%d want=%d", tc.name, got, tc.want)
            }
        })
    }
}

这样生成的名称同时具备排序、筛选和复查价值。若业务输入本身可能重复，给每行增加稳定的样本 ID；不要使用当前时间、内存地址或随机数，否则失败重跑时名称会变化。

有意重复时的处理边界

如果两条数据确实表示相同业务场景，可以保留相同标签，但应让数据 ID 进入名称，例如 12-cache、13-cache。如果只关心断言而不需要单独筛选，自动后缀并不会影响正确性；一旦测试失败需要交给值班同学处理，就应该主动提供稳定语义。

名称中的斜杠会参与子测试路径分段，版本和环境等字段最好使用短横线或下划线。并行子测试还要保证名称对应的输入不可变，先完成变量捕获，再调用 t.Parallel()。最后用一次全量测试和一次精确 -run 重跑确认：日志能认出场景，筛选不会误伤同级用例。

常见问题

同名子测试会被 Go 跳过吗？

不会。Go 会追加序号来保证完整名称唯一，是否执行仍由测试函数和筛选条件决定。

能不能直接依赖自动生成的 #01？

不建议。数据顺序一变，编号就可能变化；稳定字段更适合 CI 重跑和故障记录。

名称越长越好吗？

也不是。保留能区分输入和边界的字段即可，避免把整段 JSON 塞进名称，让日志反而难读。

官方参考：https://pkg.go.dev/testing