Go中表格驱动测试需用结构体切片定义用例，配合t.Run实现子测试；必须用tt := tt避免循环变量捕获，字段命名要语义明确，错误比较用errors.Is而非==，禁用全局状态以防并发冲突。
Go 里怎么写表格驱动测试（table-driven test）
Go 官方推荐、社区主流的测试组织方式就是表格驱动，它不是语法特性，而是用一个切片（[]struct{...}）把输入、预期、说明打包，再用 for 循环跑完所有用例。核心就两点：结构体定义清晰、循环内调用 t.Run 做子测试。
别用 func TestXxx(t *testing.T) 硬写一堆 if 判断——那样难维护、报错看不出是哪条 case 挂了、加新 case 要复制粘贴逻辑。
实操建议：
- 每个测试用例用匿名或具名结构体，字段名要语义明确，比如
input、expectedErr、want，避免用in/out这种模糊缩写 - 用
t.Run(name, func(t *testing.T){...})包裹单个 case，name最好含关键输入值（如fmt.Sprintf("input_%v", tc.input)），失败时能一眼定位 - 结构体切片定义紧挨测试函数，别抽到包级变量——否则并发测试可能被意外修改
为什么必须用 t.Run 而不是直接 for 循环断言
不用 t.Run 的后果很实际：某个 case 失败，整个测试函数就中断，后面 case 全不跑；错误信息里只显示 TestParseInt，看不出是 “负数输入” 还是 “空字符串” 出问题；而且 go test -run=TestParseInt/empty 这类子测试过滤根本无效。
立即学习“go语言免费学习笔记（深入）”；
t.Run 把每个 case 变成独立生命周期的子测试，带来三个硬好处：
- 单个 case
t.Fatal不影响其他 case 执行 - 失败输出带层级路径，比如
TestParseInt/empty_string - 支持按子测试名精确运行：
go test -run=TestParseInt/zero
注意：子测试默认并发执行（t.Parallel() 需显式加），如果 case 间有共享状态（比如改了全局 map），得关掉并发或加锁。
table-driven test 常见翻车点
新手常在结构体字段设计和错误比较上栽跟头：
- 用
error字段存预期错误时，别直接写errors.New("xxx")—— 因为每次新建 error 实例地址不同，==比较必失败；改用errors.Is(tc.expectedErr, wantErr)或检查错误文本（strings.Contains(err.Error(), "xxx")） - 结构体里混用指针和值类型字段（比如
*int和string），循环中取地址容易误捕获循环变量（&tc是同一地址）；安全写法是用索引遍历，或在循环体内声明新变量：tc := tc - 测试 HTTP handler 或依赖外部服务时，别把真实
http.Client或数据库连接塞进 table —— 应该提前 mock，table 里只放请求参数和期望响应码/Body 片段
一个够用的最小完整示例
假设测试一个解析版本号的函数 ParseVersion(s string) (int, int, int, error)：
func TestParseVersion(t *testing.T) {
tests := []struct {
name string
input string
wantMaj int
wantMin int
wantPatch int
wantErr bool
}{
{"valid_v1_2_3", "1.2.3", 1, 2, 3, false},
{"invalid_empty", "", 0, 0, 0, true},
{"invalid_alpha", "1.a.3", 0, 0, 0, true},
}
for _, tt := range tests {
tt := tt // 必须！防止闭包捕获循环变量
t.Run(tt.name, func(t *testing.T) {
gotMaj, gotMin, gotPatch, err := ParseVersion(tt.input)
if tt.wantErr {
if err == nil {
t.Fatal("expected error but got nil")
}
return
}
if err != nil {
t.Fatalf("unexpected error: %v", err)
}
if gotMaj != tt.wantMaj || gotMin != tt.wantMin || gotPatch != tt.wantPatch {
t.Errorf("ParseVersion(%q) = (%d,%d,%d), want (%d,%d,%d)",
tt.input, gotMaj, gotMin, gotPatch,
tt.wantMaj, tt.wantMin, tt.wantPatch)
}
})
}
}
这个例子没抽工具函数、没用第三方库，靠原生 t.Run + 显式字段覆盖了 95% 的日常场景。真正难的不是写法，是想清楚哪些维度该放进 table（比如要不要覆盖 nil 输入、超长字符串、UTF-8 边界字符），这些得从函数契约和用户可能传的烂数据出发去枚举。
