Go testing.T TempDir 如何处理并行测试目录

并行子测试里处理临时文件，最稳妥的做法是让每个子测试自己调用 t.TempDir()。它返回当前测试专属的唯一目录，测试及其全部子测试结束后会自动删除目录和内容。这样既不用手写清理，也不会因为多个 t.Parallel() 用例都写入 input.txt 而互相覆盖。

t.TempDir 的目录归属和清理时机

TempDir 是 testing.T 提供的测试资源入口。每次调用都会得到一个新的目录；如果创建失败，测试会直接失败。它和 os.TempDir() 的区别在于，后者只返回系统临时目录的位置，不负责为当前测试建立隔离空间，也不替你清理文件。

目录的归属要看调用它的测试对象。如果是父测试调用，目录会覆盖父测试和它创建的子测试；如果是子测试调用，目录只服务于这个子测试。官方实现会把清理动作挂到测试生命周期上，因此不需要在正文代码里再写一组容易遗漏的 defer os.RemoveAll。

并行子测试应在自己的 TempDir 中写入文件

如果每个用例都要生成同名输入文件，把目录创建放到子测试函数里。下面的 t.Parallel() 只表示调度可以并行，真正的隔离来自每个子测试独立调用 t.TempDir()。

func TestParallelFiles(t *testing.T) {
	cases := []struct {
		name string
		data string
	}{
		{name: "alpha", data: "A"},
		{name: "beta", data: "B"},
	}

	for _, tc := range cases {
		tc := tc // 中文注释：复制循环变量，避免并行子测试共享迭代状态。
		t.Run(tc.name, func(t *testing.T) {
			t.Parallel()
			dir := t.TempDir() // 中文注释：每个子测试获得唯一且自动清理的目录。
			path := filepath.Join(dir, "input.txt")
			if err := os.WriteFile(path, []byte(tc.data), 0o600); err != nil {
				t.Fatalf("写入测试输入失败: %v", err) // 中文注释：写入失败立即终止当前用例。
			}
			got, err := os.ReadFile(path)
			if err != nil {
				t.Fatalf("读取测试输入失败: %v", err) // 中文注释：把文件读取错误保留在测试上下文中。
			}
			if string(got) != tc.data {
				t.Fatalf("读取内容 = %q，期望 %q", got, tc.data)
			}
		})
	}
}

示例中两个用例都叫 input.txt，但它们位于不同的目录，所以并行运行不会产生覆盖。循环变量复制仍然必要：目录隔离只能保护文件，不能修复闭包读取错误用例数据的问题。

共享只读夹具时把 TempDir 放在父测试

有些测试需要一份相同的模板、字典或只读样本。此时可以让父测试创建目录和文件，再把路径传给并行子测试。关键条件是：子测试只读共享文件，任何会被修改的产物仍然写入自己的 t.TempDir()。

func TestParallelReadOnlyFixture(t *testing.T) {
	root := t.TempDir() // 中文注释：父目录的清理要等所有子测试完成。
	seed := filepath.Join(root, "seed.txt")
	if err := os.WriteFile(seed, []byte("shared"), 0o600); err != nil {
		t.Fatalf("创建只读夹具失败: %v", err) // 中文注释：夹具不可用时不启动子测试。
	}

	for _, name := range []string{"one", "two"} {
		name := name
		t.Run(name, func(t *testing.T) {
			t.Parallel()
			outDir := t.TempDir() // 中文注释：结果文件仍然按子测试隔离。
			_ = outDir
			data, err := os.ReadFile(seed)
			if err != nil {
				t.Fatalf("读取共享夹具失败: %v", err) // 中文注释：这里只读共享文件，不在其上写结果。
			}
			if string(data) != "shared" {
				t.Fatalf("夹具内容异常: %q", data)
			}
		})
	}
}

父目录的清理时机正是这个写法的价值：父测试不会在子测试仍可能读取 seed.txt 时提前删除它。若共享文件需要被改写，应为每个子测试复制一份到自己的目录，而不是依赖执行顺序。

并行临时目录的排查清单

看到“文件不存在”“内容偶尔错乱”或临时目录越积越多时，可以按下面的顺序判断：

1. 确认路径来自 t.TempDir()，而不是所有用例共用的 os.TempDir() 或固定字符串。
2. 确认 t.Parallel() 子测试没有写入同一个父目录中的可变文件。
3. 确认没有在子测试返回前启动异步 goroutine 去访问其临时目录；测试生命周期结束后目录会被清理。
4. 如果只想改变临时目录根位置，检查 GOTMPDIR；它改变位置，不会取消每个 TempDir 的隔离。

常见问题

每次调用 t.TempDir 都会返回同一个目录吗？

不会。每次调用都会创建唯一目录；但同一个目录路径如果被你保存并交给多个并行用例使用，仍然可能产生业务层面的写冲突。

可以在 t.Parallel 之后调用 t.TempDir 吗？

可以。并行只影响测试调度，子测试仍可为自己创建临时目录。更重要的是不要把目录里的可变文件交给其他并行用例。

为什么测试结束后还想查看临时文件却找不到？

这是自动清理的正常结果。调试时应把关键内容写入测试日志或显式复制到外部工件目录，而不是依赖 TempDir 在测试结束后长期保留。