Go testing.T TempDir用 Setenv 隔离并行子测试环境的目录方案

测试代码需要一个可写目录时，t.TempDir()负责创建每次调用都不同、并在测试及其子测试结束后自动清理的目录；t.Setenv()负责临时设置环境变量并在测试结束时恢复。但两者的并行边界不同：Setenv修改的是整个 Go 进程的环境，不能出现在并行测试或拥有并行祖先的测试中。

先分清 TempDir 和 Setenv 的隔离对象

TempDir隔离的是文件系统目录。每次调用都会得到新的目录，测试框架会负责在测试及其全部子测试完成后清理它；如果设置了 GOTMPDIR，目录会落在该位置下面。它适合放缓存、配置片段和临时输出。

Setenv隔离的是进程环境。它通过清理回调恢复旧值，但环境变量没有“某个 goroutine 私有”这层语义。因此下面这种组合不安全：

func TestConfig(t *testing.T) {
	root := t.TempDir()
	t.Setenv("APP_DATA_DIR", root) // 中文说明：环境变量属于整个进程
	t.Parallel()                    // 中文说明：不能把全局环境带入并行测试
}

这里的关键不是临时目录能否创建，而是环境变量的可见范围。目录可以各自独立，环境变量却可能被另一个测试同时读取或修改。

被测代码只能读环境变量时，采用串行子测试

如果旧接口只能读取 APP_DATA_DIR，可以让外层测试保持串行，为每个子测试重新分配目录并注入环境变量。不要在这个测试函数或它的祖先上调用 t.Parallel()：

func TestLoadConfigFromEnv(t *testing.T) {
	cases := []struct {
		name string
		file string
	}{
		{name: "empty", file: "empty.json"},
		{name: "custom", file: "custom.json"},
	}

	for _, tc := range cases {
		t.Run(tc.name, func(t *testing.T) {
			dir := t.TempDir() // 中文说明：每个子测试拥有独立目录，结束后自动删除
			t.Setenv("APP_DATA_DIR", dir) // 中文说明：只在串行测试中临时注入全局环境
			writeFixture(t, dir, tc.file)
			if got := loadFromEnv(); got == "" {
				t.Fatalf("未从 %s 读取到配置", dir) // 中文说明：失败时保留目录路径便于定位
			}
		})
	}
}

这种写法的优点是改动小、清理明确，且每个子测试的文件不会落到同一目录。代价是这些子测试不能并行；若单个用例很慢，应优先把被测函数改成接收配置，而不是强行共享环境变量。

必须并行时，把 TempDir 作为显式配置传入

并行测试的安全方案是让每个用例携带自己的目录。配置对象可以由测试构造，再传给业务函数；业务函数不在内部读取全局环境：

type appConfig struct {
	DataDir string
}

func TestStoreInParallel(t *testing.T) {
	cases := []struct {
		name string
	}{
		{name: "first"},
		{name: "second"},
	}

	for _, tc := range cases {
		tc := tc // 中文说明：复制循环变量，避免并行闭包共享迭代状态
		t.Run(tc.name, func(t *testing.T) {
			t.Parallel() // 中文说明：此时不修改进程环境，只使用本用例目录
			cfg := appConfig{DataDir: t.TempDir()}
			if err := saveRecord(cfg, "result.json"); err != nil {
				t.Fatalf("保存测试数据失败：%v", err) // 中文说明：把具体错误交给测试输出
			}
		})
	}
}

这里的 TempDir 仍然按测试实例提供唯一目录，t.Parallel()只影响调度，不会改变目录清理规则。若业务层暂时不能改签名，可增加一个只负责组装配置的适配层；不要在并行子测试中用 os.Setenv 绕过 t.Setenv 的限制，因为那只会让竞争更隐蔽。

用四项检查确认隔离真的成立

如果测试失败后目录已经被清理，不要把固定目录当成调试手段。可以在失败时记录文件名、配置摘要和错误路径；需要保留产物时，再由测试框架支持的 artifact 目录承接，而不是破坏临时目录的生命周期。

相关问题

Setenv 会不会自动恢复原来的值？

会。t.Setenv会登记清理动作，测试结束后恢复原值；但恢复机制不能把进程环境变成并行安全的局部变量。

TempDir 创建的目录什么时候删除？

测试及其子测试全部完成后由 testing 框架删除。每次调用都会获得不同目录，创建失败会直接使测试失败。

可以让外层 Setenv、内层 Parallel 吗？

不建议也不应这样设计。外层环境会成为并行子测试的共享状态；需要并行时，把目录从环境变量改成显式配置。