使用t.Run可提升go测试的组织性与可读性，通过子测试命名便于定位问题，在表驱动测试中为每组输入创建独立子测试，支持嵌套结构和并发执行，结合-run标志可过滤运行特定用例，增强调试效率与维护性。
在Go语言中，t.Run 是 testing 包提供的一个重要方法，用于创建子测试（subtests）。它不仅能提升测试的组织性，还能让测试用例更清晰、可读性更强。特别是在需要对一组相似输入进行测试时，t.Run 显得尤为实用。
为什么使用 t.Run？
默认的测试写法往往把所有断言塞进一个函数，一旦某个断言失败，调试起来很困难。而使用 t.Run 可以：
- 将大测试拆分为多个独立的子测试
- 每个子测试有独立的名字，便于定位问题
- 支持层级结构，适合复杂场景
- 配合 -run 标志过滤执行特定子测试
基本语法与结构
t.Run 接收两个参数：子测试名称和一个函数，该函数接收 *testing.T 作为参数。
func TestExample(t *testing.T) {
t.Run(“subtest one”, func(t *testing.T) {
if 1 + 1 != 2 {
t.Error(“expected 2”)
}
})
}
运行测试时，输出会显示层级结构：
立即学习“go语言免费学习笔记（深入）”；
— PASS: TestExample (0.00s)
— PASS: TestExample/subtest_one (0.00s)
表驱动测试中使用 t.Run
最常见的实践是在表驱动测试（table-driven tests）中结合 t.Run，为每组输入创建一个子测试。
func TestAdd(t *testing.T) {
cases := []Struct {
name String
a, b int
expected int
}{
{“positive numbers”, 2, 3, 5},
{“negative numbers”, -1, -1, -2},
{“zero”, 0, 0, 0},
}
for _, tc := range cases {
t.Run(tc.name, func(t *testing.T) {
result := Add(tc.a, tc.b)
if result != tc.expected {
t.Errorf(“got %d, want %d”, result, tc.expected)
}
})
}
这样，当某个测试用例失败时，错误信息会明确指出是哪一个 case 出错，比如：
— FaiL: TestAdd (0.00s)
— FAIL: TestAdd/negative_numbers (0.00s)
控制子测试执行与并发
t.Run 默认是顺序执行子测试。如果你想并发运行，可以在子测试中调用 t.Parallel()：
t.Run(“parallel test”, func(t *testing.T) {
t.Parallel()
// 测试逻辑 })
注意：只有在外层测试函数没有阻塞性操作的前提下，并发才有效果。同时要确保并发测试之间无共享状态冲突。
还可以通过命令行只运行某个子测试：
go test -run TestAdd/positive
这在调试特定用例时非常高效。
嵌套子测试的使用场景
有时你需要更深层级的组织方式，比如按功能模块再分场景：
t.Run(“User API”, func(t *testing.T) {
t.Run(“Create”, func(t *testing.T) { … })
t.Run(“Update”, func(t *testing.T) { … })
t.Run(“delete”, func(t *testing.T) { … })
})
这种结构让测试报告更加清晰，也方便团队协作维护。
基本上就这些。合理使用 t.Run 能显著提升 Go 测试的可维护性和可读性，尤其在项目变大后优势更明显。