Go语言表格驱动测试必须用[]struct{}定义用例、for循环遍历、t.Run()创建子测试;结构体字段需语义明确且与函数签名对齐,name字段不可为空,须避免循环变量捕获,错误比较用errors.Is而非==,禁用全局状态以防并发冲突。

Go 语言没有参数化测试语法,表格驱动测试(table-driven test)是唯一被标准库和主流项目验证的替代方案——它靠 []struct{} + for + t.Run() 三件套实现,写错结构或忽略闭包陷阱,测试就漏跑、误判、难定位。
怎么定义测试用例结构体才不翻车
结构体字段必须显式、语义清晰,且与被测函数签名对齐。别用 map[string]interface{} 或平行切片(如 inputs []string 和 expects []int),否则增删用例时极易错位,IDE 也无法跳转或检查字段存在性。
-
name string字段必须有,且非空;推荐带输入摘要,如"input_42"或"empty_string_returns_error",否则go test -run=TestXxx/过滤失效 - 输入字段名直接对应函数参数,如被测函数是
ParseURL(s string) (url.URL, error),就用input string,别缩写成in - 预期字段按返回值拆开:若函数返回
(int, error),结构体里就要有wantN int和wantErr bool(或wantErr error),不能合并为want interface{} - 所有字段尽量导出(首字母大写),避免反射或 future 工具读不到;零值要显式写出,比如
opts []Option即使某 case 不传也要写opts: nil
为什么 t.Run() 不是可选,而是必须
不用 t.Run() 的后果很实际:一个 t.Fatal() 就终止整个测试函数,后续用例全不执行;失败日志只显示 TestParseInt,看不出是哪个输入崩了;go test -run=TestParseInt/zero 这类子测试过滤完全无效。
-
t.Run()为每个用例创建独立的*testing.T实例,让t.Fatal、t.Parallel()、t.Cleanup()都只作用于当前 case -
t.Parallel()必须在t.Run()的回调函数内调用,否则 panic;并发下若 case 共享全局状态(如修改包级map),需手动加锁或禁用并发 - 名字含
/(如"Parse/valid")会自动分组,在go test -v输出中缩进显示,方便归类
闭包里直接用 tc 为什么会出问题
现象是所有子测试失败信息一模一样,或者只有最后一个用例通过——根本原因是 Go 的 for _, tc := range cases 复用循环变量地址,闭包捕获的是指针,不是值。
立即学习“go语言免费学习笔记(深入)”;
- 错误写法:
for _, tc := range cases { t.Run(tc.name, func(t *testing.T) { use tc.input }) }→ 所有子测试实际访问的是最后一个tc - 正确写法一:在循环体内声明新变量,
tc := tc,再传入t.Run - 正确写法二:用索引遍历,
for i := range cases { tc := cases[i]; t.Run(tc.name, func(t *testing.T) { ... }) } - 别试图用
&cases[i]绕开——既破坏类型安全,又让 IDE 提示失效
error 和浮点数怎么比才可靠
直接比 err == tc.wantErr 几乎总是错的:自定义 error 每次新建实例地址不同;err.Error() == "xxx" 会被日志格式、i18n、路径变更轻易打穿;reflect.DeepEqual 对 error 和 float64 都不可靠。
- 只关心是否出错:用
if tc.wantErr && err == nil和if !tc.wantErr && err != nil分开断言 - 验证错误类型:用
errors.Is(err, io.EOF)或errors.As(err, &myErr)再检查字段 - 浮点数比较:别存
want float64,改用wantFloat, tolerance float64,然后if math.Abs(got - tt.wantFloat) > tt.tolerance - 时间比较:用
got.Equal(tt.wantTime),别用reflect.DeepEqual—— 时区、单调时钟会影响结果
最常被忽略的点是:表格数据本身没做边界校验。比如 input []string 里写了 nil,而被测函数没处理,测试直接 panic;又比如被测函数接收 *Config,table 里传了 nil 却没加 recover 检查 —— 这些都不会报“测试失败”,而是报“panic”,掩盖真实问题。


















