Go 测试用 t.TempDir 后文件为什么还在：清理时机、子测试隔离与路径边界

测试里把文件写进当前项目目录，跑完后经常留下半成品和互相覆盖的 fixture。Go 的 t.TempDir 可以把这件事收回来：它创建一个临时目录，并在当前测试及其子测试全部结束后自动清理。真正容易误判的是清理时机——测试函数返回不等于目录立刻消失，子测试还没结束时，目录仍然应该可用。

t.TempDir 适合测试期间的临时文件，不适合把路径带出测试生命周期。需要失败后保留现场时，应显式复制到指定诊断目录，而不是依赖临时目录“碰巧还在”。

t.TempDir 到底什么时候清理

最小用法很直接：

func TestWriteConfig(t *testing.T) {
    dir := t.TempDir()
    path := filepath.Join(dir, "app.conf")
    if err := os.WriteFile(path, []byte("port=8080\n"), 0o600); err != nil {
        t.Fatal(err)
    }
}

目录名由测试框架生成，测试结束时由框架负责清理。这个目录不是在 t.TempDir() 返回后马上注册一个“稍后随便删除”的任务，而是绑定到测试生命周期，因此测试中的后续断言仍可以读取同一目录。

为什么子测试结束前目录还不能删

父测试创建的资源通常会被子测试共享。下面的写法中，父测试不能在 t.Run 返回前手动删除目录，否则并行或延迟执行的子测试会遇到路径不存在：

func TestConfigCases(t *testing.T) {
    dir := t.TempDir()
    cases := []struct{ name, value string }{
        {"default", "8080"},
        {"custom", "9090"},
    }
    for _, tc := range cases {
        tc := tc
        t.Run(tc.name, func(t *testing.T) {
            path := filepath.Join(dir, tc.name+".conf")
            if err := os.WriteFile(path, []byte("port="+tc.value), 0o600); err != nil {
                t.Fatal(err)
            }
        })
    }
}

如果子测试调用 t.Parallel()，每个子测试都必须使用独立文件名，或者在自己的子测试里再次调用 t.TempDir()。共享目录没有问题，共享文件名才容易造成覆盖和顺序依赖。

把路径作为依赖传给被测代码

临时目录最常见的坏味道，是业务函数偷偷写入当前工作目录。让函数接收目录，测试就能控制边界，生产代码也不会携带测试专用路径：

func writeConfig(dir, name string, data []byte) error {
    if name == "" || filepath.Base(name) != name {
        return fmt.Errorf("invalid file name")
    }
    return os.WriteFile(filepath.Join(dir, name), data, 0o600)
}

func TestWriteConfig(t *testing.T) {
    dir := t.TempDir()
    if err := writeConfig(dir, "app.conf", []byte("enabled=true")); err != nil {
        t.Fatal(err)
    }
    got, err := os.ReadFile(filepath.Join(dir, "app.conf"))
    if err != nil {
        t.Fatal(err)
    }
    if string(got) != "enabled=true" {
        t.Fatalf("unexpected content: %q", got)
    }
}

这里额外检查了文件名不能携带路径片段。filepath.Join 负责拼接，不等于自动完成业务授权；如果被测函数接收的是用户传入的相对路径，仍要先定义允许的文件名或目录范围。

失败时想保留文件，应该复制而不是依赖临时目录

本地排查时，测试失败后临时目录可能还没来得及被清理，但这不是稳定契约。若确实需要保存现场，可以在失败分支把关键文件复制到环境变量指定的诊断目录：

func keepFailureFile(t *testing.T, src string) {
    dstDir := os.Getenv("TEST_DIAGNOSTIC_DIR")
    if dstDir == "" {
        return
    }
    data, err := os.ReadFile(src)
    if err != nil {
        t.Logf("read failure artifact: %v", err)
        return
    }
    dst := filepath.Join(dstDir, t.Name()+".conf")
    if err := os.WriteFile(dst, data, 0o600); err != nil {
        t.Logf("write failure artifact: %v", err)
    }
}

诊断目录由测试运行环境负责生命周期，t.TempDir 只负责正常测试输入。两者边界分开后，CI 可以默认清理临时目录，开发机又能按需保留失败证据。

用检查表覆盖四个容易漏掉的边界

最后用竞态检测和完整测试确认资源边界：

go test -race ./...

如果测试偶发报“文件不存在”，先检查是不是把清理动作写进了父测试的 defer，或者多个并行子测试用了同一个文件名。若问题只在 CI 出现，再打印 t.TempDir() 返回的路径和测试名称，通常比盲目增加等待时间更快定位。

相关问题

t.TempDir 和 os.MkdirTemp 有什么区别？

os.MkdirTemp 返回普通目录，需要调用方决定何时清理；t.TempDir 把清理绑定到测试生命周期，更适合测试夹具和临时输出。

可以在测试结束后继续使用 t.TempDir 返回的路径吗？

不应这样设计。测试结束后目录可能已经被清理，调用方应在测试内部完成读取或把需要的证据复制到独立目录。

并行子测试是否必须各自调用 t.TempDir？

不是必须。只要共享父目录时文件名、状态和清理责任都隔离清楚即可；复杂场景下每个子测试创建自己的目录更不容易互相影响。

把临时目录当成测试边界

t.TempDir 的价值不只是少写一行 RemoveAll，而是让输入文件、测试代码和清理时机落在同一个生命周期里。目录用于测试期间的资源隔离，诊断目录用于失败证据保留；把这两个用途分开，测试就不会因为本地残留或 CI 清理时机不同而出现难以复现的结果。