17370845950

Go 语言通过 t.Parallel() 支持顶层测试函数并发执行以缩短测试时间，需满足用例独立、无共享状态等条件，并配合 -p 参数控制并发度，子测试中可单独调用以提升粒度。

Go 语言原生支持并行测试，通过 t.Parallel() 可以让多个测试函数在不同 goroutine 中并发执行，显著缩短整体测试时间。但要注意：它只对**顶层测试函数（即 TestXxx）有效**，且需配合 -p 或 GOMAXPROCS 控制并发度，同时避免共享状态引发竞态。

何时适合调用 t.Parallel()

当多个测试用例彼此独立、不读写相同全局变量、不操作同一文件或数据库、不依赖执行顺序时，就可以安全启用并行。例如验证纯函数逻辑、JSON 序列化、正则匹配等场景。

• 测试函数内部没有修改包级变量或全局 map/slice
• 不调用 t.Setenv 或修改 os.Args 等影响环境的操作
• 未使用 time.Sleep 模拟延迟（应改用 testutil 类工具或通道控制）

如何正确启用并行测试

在测试函数开头调用 t.Parallel() 即可。Go 运行时会将该测试推迟到有空闲 goroutine 时执行，并与其他并行测试共享运行时资源。

func TestAdd(t *testing.T) {
    t.Parallel() // 必须放在最前面（在任何 t.Fatal/t.Error 前）
    if got := Add(2, 3); got != 5 {
        t.Errorf("expected 5, got %d", got)
    }
}

运行时加上 -p=4 参数限制最多 4 个测试同时运行：
go test -p=4

避免常见陷阱

并行测试不是“加个 t.Parallel 就完事”，错误使用反而导致失败难排查。

• 不要在子测试（t.Run）里调用 t.Parallel() 后再调用 t.Parallel() —— 子测试默认继承父测试的并行策略，重复调用无意义
• 若某组测试必须串行（比如共用一个 mock server），就不要加 t.Parallel()，或把它们归入同一个非并行测试函数中
• 使用 go test -race 检测潜在数据竞争，尤其在初始化阶段或 setup/teardown 中有共享资源时

结合子测试提升组织性与并行粒度

用 t.Run 划分逻辑用例，每个子测试单独调用 t.Parallel()，能更细粒度地利用 CPU 资源：

func TestValidateEmail(t *testing.T) {
    tests := []struct{
        name, input string
        want bool
    }{
        {"empty", "", false},
        {"valid", "a@b.c", true},
        {"invalid", "@b.c", false},
    }
    for _, tt := range tests {
        tt := tt // 防止循环变量捕获问题
        t.Run(tt.name, func(t *testing.T) {
            t.Parallel()
            if got := ValidateEmail(tt.input); got != tt.want {
                t.Errorf("ValidateEmail(%q) = %v, want %v", tt.input, got, tt.want)
            }
        })
    }
}

这样每个子测试都可独立并行，又保持结构清晰、失败定位准确。