Go testing.T.Chdir 后并行子测试为什么读到错误目录

如果在 Go 测试里调用 t.Chdir 后又让子测试并行运行，先不要把问题归咎于子测试没有捕获循环变量。真正的原因通常是：当前工作目录是整个测试进程共享的状态，而不是每个 testing.T 独有的字段。Go 现在会直接阻止“使用 t.Chdir 的测试调用 t.Parallel”这类组合；如果旧代码自己调用 os.Chdir，则可能真的出现并发读到错误目录。

把工作目录当成测试输入，而不是测试隔离机制。并行子测试使用显式的绝对路径；需要写临时文件时使用每个子测试自己的 t.TempDir()，不要依赖共享的进程级 cwd。

• 改变范围：t.Chdir 最终改变的是进程工作目录，Cleanup 只在测试结束时恢复。
• 并行边界：使用 t.Chdir 的测试不能调用 t.Parallel，带并行祖先的测试也不能这样做。
• 稳定改法：先确定资源根目录，再把绝对路径传给子测试；临时输出交给 t.TempDir。

先看清 t.Chdir 的共享状态边界

testing.T.Chdir 的便利之处是把切换目录和恢复动作绑定在测试生命周期里。官方文档说明，它调用 os.Chdir，并使用 Cleanup 在测试结束后恢复原目录；在 Unix 上还会同步维护测试期间的 PWD。这里的关键不是“自动恢复”，而是“切换动作仍然作用于整个进程”。

因此，t.Chdir 并没有创建一个只属于当前子测试的工作目录副本。任何通过相对路径访问文件的代码，都会把当时进程看到的 cwd 当成解析起点。Cleanup 能把状态恢复到进入测试前，却不能把同一时刻的两个 cwd 拆成两个并行版本。

为什么并行子测试会触发错误或错读

子测试调用 t.Parallel() 后，会暂停到串行测试阶段结束，再与其他允许并行的测试一起调度。这个机制适合共享只读配置、独立输入和独立输出，但不适合把进程级 cwd 当作隐式参数。

在当前 testing 实现里，t.Chdir 会让测试进入禁止并行的状态；随后同一个测试调用 t.Parallel，或者它的祖先已经使用了会影响全进程的目录切换，就会触发 testing 的并行冲突保护。这是有意的失败：它比让两个测试悄悄互相覆盖 cwd 更容易定位。

旧代码若直接调用 os.Chdir，没有这层保护，就会出现更隐蔽的现象：子测试 A 刚把 cwd 切到 fixtures/a，子测试 B 又切到 fixtures/b，A 随后读取相对路径时得到的可能已经是 B 的目录。问题看起来像“并行子测试读错数据”，本质却是共享进程状态被交错修改。

func TestLegacyChdirRace(t *testing.T) {
    cases := []struct {
        name string
        dir  string
    }{
        {name: "A", dir: "fixtures/a"},
        {name: "B", dir: "fixtures/b"},
    }

    for _, tc := range cases {
        tc := tc // 中文注释：固定本轮子测试要使用的用例值。
        t.Run(tc.name, func(t *testing.T) {
            t.Parallel()
            // 中文注释：旧式 os.Chdir 改的是整个进程，不能给并行子测试隔离 cwd。
            if err := os.Chdir(tc.dir); err != nil {
                t.Fatal(err)
            }
            // 中文注释：相对路径解析依赖共享 cwd，这里可能被另一个子测试改写。
            data, err := os.ReadFile("input.txt")
            if err != nil {
                t.Fatal(err)
            }
            t.Logf("读取 %d 字节", len(data))
        })
    }
}

这段示例还需要导入 os。它的重点不是鼓励复现竞态，而是说明为什么“每个子测试先 Chdir 到自己的目录”不能成为并行隔离方案。即使加上互斥锁，测试也只是串行地借用同一个 cwd，失去了并行价值。

把目录从隐式状态改成显式输入

如果测试资源是仓库中固定的只读文件，最稳妥的模式是一次确定资源根目录，再把它拼成绝对路径传给被测函数。子测试可以继续并行，因为它们只读取自己的输入，不会改写进程 cwd。

func readFixture(root, name string) ([]byte, error) {
    // 中文注释：root 是显式输入，函数不再依赖进程当前工作目录。
    return os.ReadFile(filepath.Join(root, name))
}

func TestFixtures(t *testing.T) {
    root := filepath.Join("testdata", "fixtures")
    cases := []struct {
        name string
        file string
    }{
        {name: "A", file: "a/input.txt"},
        {name: "B", file: "b/input.txt"},
    }

    for _, tc := range cases {
        tc := tc // 中文注释：避免闭包读取变化中的循环变量。
        t.Run(tc.name, func(t *testing.T) {
            t.Parallel()
            // 中文注释：每个子测试只构造自己的绝对资源路径。
            path := filepath.Join(root, tc.file)
            data, err := os.ReadFile(path)
            if err != nil {
                t.Fatal(err)
            }
            if len(data) == 0 {
                t.Fatal("fixture 为空")
            }
        })
    }
}

这里的 root 虽然由相对片段构造，但它只在测试开始时作为普通字符串使用；更严格的工程可以在测试入口把它转换为绝对路径，或者由测试配置传入绝对根目录。核心是：读取函数签名里出现了目录，调用关系里不再隐藏 cwd 依赖。

临时文件用 t.TempDir，不要复用共享目录

另一类常见场景是测试需要写输出文件。此时不应该让多个子测试竞争一个仓库内的 tmp 目录，更不应该通过切换 cwd 来让被测代码“自动找到”它。t.TempDir() 会为当前测试提供临时目录，并在测试及其子测试完成后清理；每次调用还会得到独立目录。

func TestWriteReports(t *testing.T) {
    cases := []string{"A", "B"}
    for _, name := range cases {
        name := name // 中文注释：固定并行子测试的报告名称。
        t.Run(name, func(t *testing.T) {
            t.Parallel()
            dir := t.TempDir()
            // 中文注释：每个子测试拥有独立输出目录，不需要修改全局 cwd。
            path := filepath.Join(dir, "report.txt")
            if err := os.WriteFile(path, []byte(name), 0o600); err != nil {
                t.Fatal(err)
            }
            // 中文注释：被测函数接收显式路径，测试结束后的清理由 testing 负责。
            if _, err := os.Stat(path); err != nil {
                t.Fatal(err)
            }
        })
    }
}

如果被测函数的接口只能接受相对路径，可以把“相对路径解析”封装在一个串行适配层中，或者优先改造接口让它接收目录参数。不要用一个全局锁把所有并行测试包住后继续修改 cwd：那只能掩盖设计问题，并且会让测试调度变得难以理解。

常见问题

调用 t.Chdir 后为什么不能再调用 t.Parallel？

因为二者的作用域冲突：t.Chdir 修改整个测试进程的工作目录，而 t.Parallel 允许多个测试交错执行。testing 选择在运行时拒绝这种组合，避免产生静默的目录竞争。

只读文件也必须避免 t.Chdir 吗？

如果测试保持串行，t.Chdir 可以用于明确的兼容场景；但只读并不等于没有共享状态，因为相对路径解析仍依赖进程 cwd。希望并行时，应把资源根目录显式传给读取逻辑。

结语：把 cwd 当作边界，而不是夹具

testing.T.Chdir 解决的是“测试结束后恢复目录”的生命周期问题，不解决“多个测试拥有各自目录”的隔离问题。看到并行子测试读到错误目录时，先检查是否有隐式 cwd 依赖；随后把资源路径和输出目录改成显式输入。这样既遵守 testing 的并行边界，也让测试失败更接近真实原因。