Go t.Chdir 失败时怎样保证测试进程工作目录恢复

测试代码一旦调用 os.Chdir，改变的是整个 Go 测试进程的工作目录。断言失败、提前返回或子测试嵌套时，如果恢复逻辑漏掉一个分支，后面的测试就可能在错误目录里运行。Go 1.24 提供的 t.Chdir 把“切换目录”和“注册恢复清理”绑在一起：切换成功后，即使当前测试失败，Cleanup 阶段也会回到原目录。

t.Chdir 为什么能在失败后恢复工作目录

t.Chdir 的关键不是简单包一层 os.Chdir，而是先保存当前目录，再把恢复动作注册到当前测试的 Cleanup 队列。测试主体正常返回、调用 t.Fatal，或者某个子测试结束，测试框架都会执行这组清理函数。Unix 系统上，它还会在切换期间更新 PWD，避免环境变量和实际目录脱节。

用 t.TempDir 写一个可验证的失败路径

最稳妥的测试组合是 t.TempDir 加 t.Chdir。前者负责创建并在测试结束后删除临时目录，后者负责工作目录恢复。下面故意在切换后调用 t.Error，用 Cleanup 检查恢复动作仍然会发生；检查点放在外层测试，避免把同一个测试的清理时机误判成“立即恢复”。

func TestChdirRestoresAfterFailure(t *testing.T) {
	before, err := os.Getwd()
	if err != nil {
		t.Fatal(err) // 读取基准目录失败时没有继续测试的意义
	}

	tmp := t.TempDir()
	t.Chdir(tmp) // testing.T 自动登记恢复原目录的 Cleanup
	if got, err := os.Getwd(); err != nil || got != tmp {
		t.Fatalf("工作目录未切换: got=%q err=%v", got, err) // 只验证切换结果
	}
	t.Error("模拟业务断言失败") // 失败不会跳过已经登记的 Cleanup

	t.Cleanup(func() {
		got, err := os.Getwd()
		if err != nil || got != before {
			t.Fatalf("清理后目录不正确: got=%q want=%q err=%v", got, before, err) // 外层收尾时核对恢复结果
		}
	})
}

这个例子表达的是生命周期，不建议在生产测试中用一个故意失败的断言作为长期回归用例。实际项目可以把后续逻辑放入子测试，并在外层的 Cleanup 或下一条独立测试中观察目录没有泄漏。

三个容易让恢复逻辑失效的边界

特别要注意：t.Chdir 会检查并行状态，测试本身或任一并行祖先不能使用它。即使两个测试访问的是不同目录，也不能靠“目录不同”抵消进程级状态竞争。目标目录不存在时，切换本身会失败；这和“切换成功后测试断言失败”是两条不同路径，应分别排查。

旧版本怎样保留同样的恢复保证

如果模块仍要兼容 Go 1.23 或更早版本，可以把恢复逻辑集中在测试函数入口，避免散落在多个返回分支：

func chdirForOldGo(t *testing.T, dir string) {
	old, err := os.Getwd()
	if err != nil {
		t.Fatal(err) // 没有原目录就无法安全恢复
	}
	if err := os.Chdir(dir); err != nil {
		t.Fatal(err) // 切换失败时不注册无效的恢复动作
	}
	t.Cleanup(func() {
		if err := os.Chdir(old); err != nil {
			panic(err) // 测试进程无法回到原目录时应立即暴露问题
		}
	})
}

兼容写法至少要保证“切换成功后才登记恢复”，并把恢复失败视为测试基础设施错误。能升级到 Go 1.24 时，优先使用 t.Chdir，让标准库负责保存目录句柄和 Unix 下的 PWD 同步。

相关问题

t.Chdir 失败后会不会自动恢复到原目录？

如果指目标目录不存在，切换不会成功，当前目录通常仍保持原值；如果指切换成功后测试断言失败，Cleanup 会负责恢复。

为什么 t.Chdir 不能用于并行测试？

当前工作目录是进程级状态，多个并行测试无法各自拥有独立目录。应改为把目录作为参数传给被测函数。

t.TempDir 和 t.Chdir 谁负责删除目录？

t.TempDir 负责临时目录的清理，t.Chdir 负责工作目录恢复，两者是互补关系。