Go中通过表驱动测试实现参数化,使用切片定义输入和期望输出,结合t.Run命名子测试,便于定位问题并提升可维护性。

在Golang中实现测试用例参数化,可以通过使用 表驱动测试(Table-Driven Tests) 的方式来完成。这是Go语言中最常见、最推荐的做法,能够用一组输入和期望输出来批量验证函数行为,提升测试覆盖率和可维护性。
什么是表驱动测试
表驱动测试是指将测试用例组织成一个切片,每个元素包含输入数据和预期结果。通过循环遍历这些用例,逐一执行并验证结果。这种方式避免了重复编写多个相似的测试函数。
示例:测试一个加法函数假设我们有一个简单的加法函数:
func Add(a, b int) int {
return a + b
}
我们可以这样写参数化的测试:
立即学习“go语言免费学习笔记(深入)”;
func TestAdd(t *testing.T) {
tests := []struct {
name string
a, b int
expected int
}{
{"positive numbers", 2, 3, 5},
{"negative numbers", -1, -1, -2},
{"zero", 0, 0, 0},
{"mixed", -5, 5, 0},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
result := Add(tt.a, tt.b)
if result != tt.expected {
t.Errorf("Add(%d, %d) = %d; expected %d", tt.a, tt.b, result, tt.expected)
}
})
}
}
使用 t.Run 区分子测试
t.Run 可以为每个测试用例命名,运行时能清楚看到是哪个用例失败。配合 -run 标志还可以单独运行某个用例:
-
go test -run=TestAdd/positive—— 只运行正数相加的用例 - 输出更清晰,便于调试
适用于多种场景
表驱动不仅适用于简单函数,还可用于:
- HTTP handler 测试:构造不同请求,检查响应状态码和 body
- 字符串处理函数:测试各种边界情况
- 错误路径验证:检查函数是否在预期条件下返回正确错误
func Divide(a, b float64) (float64, error) {
if b == 0 {
return 0, errors.New("division by zero")
}
return a / b, nil
}
func TestDivide(t *testing.T) {
tests := []struct {
name string
a, b float64
expected float64
expectErr bool
}{
{"valid division", 6, 3, 2, false},
{"divide by zero", 1, 0, 0, true},
{"negative", -4, 2, -2, false},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
result, err := Divide(tt.a, tt.b)
if tt.expectErr {
if err == nil {
t.Error("expected error but got none")
}
} else {
if err != nil {
t.Errorf("unexpected error: %v", err)
}
if result != tt.expected {
t.Errorf("got %f, want %f", result, tt.expected)
}
}
})
}
}
小技巧与最佳实践
- 给每个测试用例命名,便于定位问题
- 结构体字段根据需要扩展,比如加入
setup()或teardown()函数 - 可以将测试数据定义为变量,方便复用或从外部加载(如 JSON)
- 结合 golden 文件 用于复杂输出比对










