本文介绍如何为 go 中返回多个值的函数编写清晰、可维护的表驱动测试，通过结构体字段映射各返回值，实现类型安全、语义明确的断言逻辑。
本文介绍如何为 go 中返回多个值的函数编写清晰、可维护的表驱动测试，通过结构体字段映射各返回值，实现类型安全、语义明确的断言逻辑。
在 Go 的表驱动测试（Table-Driven Tests）中，当被测函数返回多个值（如 func half(n int) (int, bool)）时，核心思路是：让测试用例结构体的字段与函数返回值一一对应，而非尝试将多值“打包”成字符串或接口。这既保持了类型安全性，又提升了可读性与可调试性。
以下是一个完整、 idiomatic 的实践示例：
// 被测函数：对整数取半，并返回结果及是否为偶数的布尔标志
func half(n int) (int, bool) {
h := n / 2
e := n%2 == 0
return h, e
}
// 表驱动测试用例：每个字段对应一个返回值，命名清晰（outInt, outEven）
var halfTests = []struct {
in int
outInt int
outEven bool
}{
{1, 0, false}, // half(1) → (0, false)
{2, 1, true}, // half(2) → (1, true)
{3, 1, false}, // half(3) → (1, false)
{4, 2, true}, // half(4) → (2, true)
}
func TestHalf(t *testing.T) {
for _, tt := range halfTests {
gotInt, gotEven := half(tt.in)
if gotInt != tt.outInt || gotEven != tt.outEven {
t.Errorf("half(%d) = (%d, %v), want (%d, %v)",
tt.in, gotInt, gotEven, tt.outInt, tt.outEven)
}
}
}✅ 关键设计要点：
- 结构体字段名应具语义（如 outInt/outEven），避免模糊的 out1/out2，便于长期维护；
- 断言使用 || 连接多条件，确保任一返回值错误均触发失败，并在错误信息中同时展示实际值与期望值；
- 错误消息采用清晰格式：half(1) = (0, false), want (0, true)，便于快速定位偏差来源。
⚠️ 注意事项：
- 不要将多返回值拼接为字符串（如 "0,false"）进行比较——这会丢失类型信息、无法做精确断言，且难以调试；
- 避免使用 reflect.DeepEqual 等泛化比较——对基础类型而言过度复杂，且掩盖了本应显式声明的契约；
- 若返回值较多（如 ≥3 个），可考虑封装为命名结构体（如 type HalfResult struct { Value int; IsEven bool }），进一步提升可读性与复用性。
这种模式完全契合 Go 的简洁哲学：用明确的字段表达意图，以最小的认知成本实现健壮测试。
