如何编写Golang表格驱动测试_Golang table driven测试模式示例_技术教程

表格驱动测试是Go中最推荐的单元测试写法，通过结构体切片组织用例，配合t.Run实现命名、并行与精准定位，并支持panic和错误验证，提升可读性、可维护性与覆盖率。

Go 语言中，表格驱动测试（Table-Driven Tests）是最推荐、最清晰的单元测试写法。它把测试用例组织成结构体切片，用一个 for 循环统一执行断言，避免重复代码，提升可读性和可维护性。

定义测试表格结构

每个测试用例用一个匿名或具名结构体表示，字段通常包括：name（便于定位失败项）、input（输入参数）、expected（期望结果），以及可选的 description 或 shouldPanic 等标识。

例如测试一个字符串反转函数：

func TestReverse(t *testing.T) {
    tests := []struct {
        name     string
        input    string
        expected string
    }{
        {"empty", "", ""},
        {"single", "a", "a"},
        {"normal", "hello", "olleh"},
        {"unicode", "你好", "好你"},
    }
    // 后续遍历执行...
}

使用 t.Run 并行运行子测试

对每个测试用例调用 t.Run，传入 name 和闭包函数。这样能在 go test -v 输出中看到每个用例名，失败时精准定位；还能用 t.Parallel() 并行加速（确保用例间无共享状态）。

每个子测试独立计时、独立失败/跳过
闭包内用 := 声明变量，避免循环变量复用问题（常见坑）
建议在 t.Run 内部立刻调用 t.Parallel()，如需并行

续上例：

for _, tt := range tests {
    tt := tt // 必须复制！防止 goroutine 捕获循环变量
    t.Run(tt.name, func(t *testing.T) {
        t.Parallel()
        got := Reverse(tt.input)
        if got != tt.expected {
            t.Errorf("Reverse(%q) = %q, want %q", tt.input, got, tt.expected)
        }
    })
}

处理错误和 panic 场景

表格驱动同样适用于验证错误返回或 panic 行为。可增加布尔字段如 panicExpected 或 errorExpected，并在子测试中用 recover 或 assert.Error（配合 testify）判断。

简单原生写法示例（检测 panic）：

tests := []struct {
    name          string
    input         []int
    panicExpected bool
}{
    {"valid", []int{1, 2, 3}, false},
    {"nil-slice", nil, true},
}
for _, tt := range tests {
    tt := tt
    t.Run(tt.name, func(t *testing.T) {
        defer func() {
            r := recover()
            if tt.panicExpected && r == nil {
                t.Fatal("expected panic, but none occurred")
            }
            if !tt.panicExpected && r != nil {
                t.Fatalf("unexpected panic: %v", r)
            }
        }()
        ProcessSlice(tt.input) // 触发可能 panic 的函数
    })
}