Go testing.T.Chdir 为什么不能和并行测试一起使用

testing.T.Chdir 不能和并行测试一起使用，原因不是它没有恢复目录，而是它修改的是整个测试进程的当前工作目录。并行子测试、并行祖先以及其他同时运行的测试都会看到同一个进程级目录；只要其中一个测试切换目录，另一个测试的相对路径就可能突然指向错误位置。

官方文档：https://pkg.go.dev/testing#T.Chdir

能力来源：https://go.dev/doc/go1.24

T.Chdir 适合把一个测试暂时放到指定工作目录中，但这段测试必须保持串行；需要并行时，应优先让被测函数接收显式目录或文件路径。

T.Chdir 做了什么，为什么恢复目录仍不够

T.Chdir 在 Go 1.24 引入。它调用 os.Chdir 改变当前工作目录，并用 Cleanup 在测试结束时恢复原目录；在 Unix 上还会同步调整测试期间的 PWD 环境变量。这里的关键不是“最终能不能恢复”，而是“测试运行期间谁能看到这个变化”。

为什么 t.Parallel 和并行祖先都会触发限制

测试框架不能为每个 goroutine 创建一份独立的当前工作目录。工作目录属于进程级状态，所以两个测试只要时间上有重叠，就可能出现下面的交叉：测试 A 切到目录 A，测试 B 读取相对路径，测试 A 或 B 再进行清理。即使每个测试单独运行都正确，重叠时也可能读到错误文件、找不到配置，甚至把输出写进另一条测试的目录。

因此限制不仅针对当前测试直接调用 t.Parallel() 的情况，也覆盖“当前测试有并行祖先”的情况。父测试调用 t.Parallel() 后，后续子测试仍处在可并行的生命周期里；此时再调用 t.Chdir，本质上仍是在多个并行参与者之间写共享状态。

package chdir_test

import "testing"

func TestReadLocalConfig(t *testing.T) {
	// 这个测试需要修改进程工作目录，因此不要调用 t.Parallel。
	t.Chdir("testdata/project")
	// 被测代码使用相对路径时，会从上面的目录开始查找文件。
	if err := readConfigFromCurrentDir(); err != nil {
		// 让目录依赖失败时保留明确的测试上下文。
		t.Fatalf("读取测试配置失败: %v", err)
	}
}

这段组织方式可以工作，但它把“相对路径从哪里开始”藏在进程状态里。若同一包还有其他目录依赖测试，最好明确标记这类测试不能并行，或者进一步改造被测函数。

需要目录切换时，怎样安全地保留串行测试

如果被测程序确实只接受当前工作目录，例如验证命令行程序读取相对配置的行为，可以保留一个不调用 t.Parallel 的专门测试。把目录切换限制在最小的测试函数中，不要在包级初始化、共享 fixture 或并行祖先中调用 T.Chdir。

• 目录切换只放在需要验证相对路径语义的测试里。
• 不要把调用 T.Chdir 的测试放到已经并行化的父测试下面。
• 不要在另一个 goroutine 中继续依赖切换后的工作目录；Chdir 保护不了异步任务。

并行测试更适合显式传递目录

如果业务代码可以调整，优先把目录作为参数传入。每个并行测试用自己的 t.TempDir() 创建隔离目录，再拼出绝对路径；这样测试之间共享的是只读代码，而不是进程当前目录。

package config_test

import (
	"path/filepath"
	"testing"
)

func TestReadConfigInParallel(t *testing.T) {
	t.Parallel() // 每个用例使用独立目录，不再修改进程级工作目录。
	dir := t.TempDir() // 测试结束后由 testing 自动清理目录。
	configPath := filepath.Join(dir, "config.yaml")
	// 把明确的文件路径传给被测函数，避免隐式依赖当前目录。
	if err := readConfig(configPath); err != nil {
		// 失败信息带上本测试自己的路径，便于区分并行用例。
		t.Fatalf("读取 %s 失败: %v", configPath, err)
	}
}

这种写法的重点不是“把 Chdir 换成另一个 API”，而是把共享进程状态改成每个测试拥有的输入。被测函数接收路径后，调用方可以在并行、串行和生产环境中复用同一套接口。

发布前的最小检查清单

1. 搜索调用 t.Chdir 的测试，确认当前函数和它的祖先没有调用 t.Parallel。
2. 检查被测代码是否只能从当前目录读取；如果能接收路径，就优先改成显式参数。
3. 把异步 goroutine 使用的文件路径改成绝对路径或明确传参，不要让它继承一个会变化的工作目录。
4. 把目录切换放在单个测试内，并让测试框架负责恢复，不要自行维护全局“原目录”变量。

常见问题

只要测试最后恢复目录，就可以并行吗？

不可以。恢复动作发生在测试结束时，无法修复其他测试在中途看到错误工作目录的问题。

并行祖先没有直接调用 Chdir，子测试可以调用吗？

不建议，也不符合 T.Chdir 的限制。并行祖先意味着子测试可能与其他测试重叠，仍然共享同一个进程工作目录。

TempDir 能完全替代 Chdir 吗？

不能替代“必须验证相对路径”的场景，但对可改造的业务接口，TempDir 加显式路径通常更适合并行测试。

总结：T.Chdir 的恢复机制解决了测试结束后的清理，却没有让工作目录变成线程或 goroutine 私有状态。需要目录语义时保持串行；需要并行隔离时，把目录和文件路径作为显式输入。