Go testing.T.Parallel Table-driven 闭包变量怎么避免串值

表驱动测试里，多个子测试最后都拿到同一个输入，通常不是 t.Parallel() 改了数据，而是匿名函数捕获了循环变量。稳妥写法是在 t.Run 前把当前用例复制到新的局部变量，再让子测试调用 t.Parallel()。这样闭包保存的是本次迭代的值，和其他用例互不串读。

为什么 t.Parallel 会读到同一个用例

t.Run 接收一个闭包。闭包没有把 tc 的值自动复制进函数体，而是保留了对外层变量的引用。在旧的循环变量语义下，for range 每轮会复用这一个变量槽位；循环结束后，它通常已经保存最后一条用例。

并行测试会把这个现象放大。官方 testing 文档说明，子测试调用 t.Parallel() 后会暂停，直到非并行测试完成；t.Run 可以先返回，父测试继续创建其他子测试。父测试函数返回时，多个闭包才可能同时读取 tc，于是它们看到同一个末值。

用当前迭代副本固定每个子测试

最小修复是把复制动作放在 t.Run 外侧、当前循环体内部。下面的 tc := tc 会创建一个新的局部绑定，匿名函数只捕获这个绑定，而不是下一轮还会改变的循环变量。

func TestParseUser(t *testing.T) {
	// 每个表项都有独立输入和期望值，便于并行执行。
	cases := []struct {
		name  string
		input string
		want  string
	}{
		{"empty", "", "unknown"},
		{"admin", "admin", "admin"},
		{"guest", "guest", "guest"},
	}

	for _, tc := range cases {
		tc := tc // 复制当前迭代，避免闭包捕获会变化的循环变量。
		t.Run(tc.name, func(t *testing.T) {
			t.Parallel() // 到达并行点后暂停，等待父测试函数返回。
			got := parseUser(tc.input)
			if got != tc.want {
				t.Fatalf("parseUser(%q) = %q; want %q", tc.input, got, tc.want)
			}
		})
	}
	// 不在这里销毁并行子测试仍需要使用的共享夹具。
}

不要把复制写到匿名函数内部，例如先进入 t.Run 再复制；那时闭包可能已经因为 t.Parallel() 暂停，复制动作的执行时机仍然不可靠。复制也要放在 go test 看到的每次循环体里。

Go 1.22+ 和旧模块的差异怎么处理

Go 1.22 引入了按迭代作用域管理 for 循环变量的语义，但它由模块的 go.mod 语言版本控制。声明 go 1.22 或更高版本的模块，每次迭代的变量天然独立；旧模块仍可能保留旧行为。因此跨模块、库代码或需要旧工具链构建的测试，保留 tc := tc 仍是清晰的兼容写法。

这项修复只解决“闭包读错表项”。如果 tc 里包含切片、map、指针或带引用字段的结构体，外层复制只是复制引用，底层对象仍可能被多个子测试修改。需要隔离时，应在构造表项时复制底层数据，或让每个子测试创建自己的可变对象。

怎么排查仍然出现的串值或偶发失败

先给每个子测试使用唯一名称，并在失败信息里打印 t.Name()、输入和期望值；不要根据并行日志的先后顺序判断变量是否正确。按下面的顺序缩小问题：

# 先只运行这个测试，减少其他包和测试的干扰。
go test -run '^TestParseUser$' -count=1 -v

# 用较低并发复查资源污染，不把它当成闭包修复的替代品。
go test -run '^TestParseUser/' -count=1 -parallel=1 -v

-parallel 只控制同时运行的并行测试数量，不会改变变量捕获规则。真正要确认的是：每个子测试的输入在进入闭包前已经固定，且闭包内部没有继续改写共享对象。

相关问题

Go 1.22 以后还需要写 tc := tc 吗？

如果模块声明的语言版本是 go 1.22 或更高，循环变量按迭代隔离，通常不再需要这行。但保留它可以明确表达“子测试绑定当前表项”，对旧模块和混合工具链更稳妥。

只复制结构体为什么仍会串数据？

结构体复制是浅复制。若字段是切片、map、指针或包含引用的对象，副本仍指向同一底层数据；并行子测试修改它时，必须进一步复制或隔离该字段。

t.Parallel 和 go test -parallel 是一回事吗？

不是。t.Parallel() 把当前子测试标记为可并行并建立等待边界；-parallel 设置并行测试同时运行的上限。