Go 测试基础：testing 包与测试函数规范

本章是《Go 冒烟回归》的测试基石。你将系统掌握 Go 标准库 testing 的核心用法、测试函数的编写规范、表格驱动测试模式以及子测试的组织方式。这些能力直接决定后续冒烟测试与回归测试用例的质量和可维护性。

1. testing 包核心能力

Go 语言内置的 testing

2. Test 函数编写规范

Go 编译器通过文件名和函数名自动识别测试代码，遵循以下硬性规则：

• 文件名：必须以 _test.go 结尾，例如 calculator_test.go。
• 函数名：必须以 Test 开头，后跟首字母大写的标识符，例如 TestAdd、TestUserLogin。
• 参数：唯一参数为 *testing.T，无返回值。
• 文件位置：与待测源码放在同一包内，可访问包内私有标识符。

一个标准的测试函数结构如下：

package calculator

import "testing"

func TestAdd(t *testing.T) {
    result := Add(2, 3)
    expected := 5
    if result != expected {
        t.Errorf("Add(2, 3) = %d; want %d", result, expected)
    }
}

3. 表格驱动测试

表格驱动测试（Table-Driven Tests）是 Go 社区最推崇的测试模式。它将测试用例组织为结构体切片，通过循环逐一执行，极大减少重复代码并提升可读性。

标准实现模板：

func TestDivide(t *testing.T) {
    tests := []struct {
        name     string
        a, b     int
        expected int
        wantErr  bool
    }{
        {"positive", 10, 2, 5, false},
        {"negative", -6, 3, -2, false},
        {"divide by zero", 5, 0, 0, true},
        {"zero numerator", 0, 7, 0, false},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            got, err := Divide(tt.a, tt.b)
            if (err != nil) != tt.wantErr {
                t.Errorf("Divide(%d, %d) error = %v, wantErr %v", tt.a, tt.b, err, tt.wantErr)
                return
            }
            if got != tt.expected {
                t.Errorf("Divide(%d, %d) = %d, want %d", tt.a, tt.b, got, tt.expected)
            }
        })
    }
}

表格驱动测试的核心优势：

• 声明式用例：每个用例一行数据，新增测试只需追加结构体元素。
• 自文档化：name 字段描述测试场景，失败时直接定位。
• 与子测试天然结合：t.Run 让每个用例独立执行、独立报告。
• 边界覆盖：容易枚举正常值、边界值、异常值。

4. 子测试与 t.Run

子测试（Subtests）是 Go 1.7 引入的特性，通过 t.Run 在测试函数内创建嵌套的测试上下文。每个子测试拥有独立的 *testing.T 实例，可以单独运行、跳过或并行执行。

子测试的核心能力：

嵌套子测试的典型结构：

func TestUserService(t *testing.T) {
    // 外层初始化（例如创建数据库连接）
    db := setupDB(t)
    defer db.Close()

    t.Run("create", func(t *testing.T) {
        // 测试创建用户
        if err := createUser(db, "alice"); err != nil {
            t.Fatal(err)
        }
    })

    t.Run("query", func(t *testing.T) {
        // 测试查询用户
        user, err := queryUser(db, "alice")
        if err != nil {
            t.Fatal(err)
        }
        if user.Name != "alice" {
            t.Errorf("got %s, want alice", user.Name)
        }
    })
}

5. 测试执行流程与结构图

下图展示了 Go 测试从文件识别到子测试执行的完整流程：

6. 测试组织与运行对比

下表对比了不同测试组织方式在冒烟回归场景中的适用性：