当前位置：首页 > 文章列表 > Golang > Go教程 > Go testing.TB.TempDir 如何隔离测试文件：生命周期、并发与清理顺序

Go testing.TB.TempDir 如何隔离测试文件：生命周期、并发与清理顺序

来源：17golang原创 2026-08-28 14:54:37 0浏览收藏

CI 里偶尔出现一类很烦的失败：单测单独运行没问题，和其他测试一起跑却读到了上一轮留下的 JSON。根因通常不是断言，而是多个测试共用了一个固定目录。Go 的 testing.TB.TempDir 把目录创建、唯一命名和测试结束后的清理交给测试框架，正适合这类文件型测试。

要点速览

t.TempDir() 返回当前测试专属目录，目录在测试结束后自动清理。
子测试和并发测试应在各自的测试上下文里获取目录，不要把一个固定路径分给所有用例。
把目录路径传给被测函数，测试只校验结果；不要让业务代码猜测试目录。
需要观察失败现场时，先理解清理时序，再决定是否临时复制证据。

先把固定目录问题复现出来

假设被测函数会把配置写到目录下的 result.json。下面这个测试把所有用例都指向 testdata/runtime，顺序一变就可能互相覆盖。这里先不急着改业务代码，先让测试暴露出“共享目录”这个变量。

func writeResult(dir string, value string) error {
    return os.WriteFile(filepath.Join(dir, "result.json"), []byte(value), 0o600)
}

func TestWriteResult(t *testing.T) {
    dir := filepath.Join("testdata", "runtime")
    if err := os.MkdirAll(dir, 0o755); err != nil {
        t.Fatal(err)
    }
    if err := writeResult(dir, "case-a"); err != nil {
        t.Fatal(err)
    }
    got, err := os.ReadFile(filepath.Join(dir, "result.json"))
    if err != nil {
        t.Fatal(err)
    }
    if string(got) != "case-a" {
        t.Fatalf("result = %q", got)
    }
}

这个例子还有一个隐藏成本：测试失败后，testdata/runtime 会留在仓库工作区，下一次运行继续读取它。文件内容即使正确，也不能证明测试之间没有耦合。

用 t.TempDir 建立测试专属目录

改造的关键只有一处：目录由 t.TempDir() 创建，再作为参数传入 writeResult。TempDir 是 testing.TB 提供的测试辅助方法，因此在普通测试、基准测试和示例测试的兼容辅助代码里，都可以通过对应的测试对象取得目录。

func TestWriteResult(t *testing.T) {
    dir := t.TempDir()
    if err := writeResult(dir, "case-a"); err != nil {
        t.Fatal(err)
    }

    got, err := os.ReadFile(filepath.Join(dir, "result.json"))
    if err != nil {
        t.Fatal(err)
    }
    if string(got) != "case-a" {
        t.Fatalf("result = %q", got)
    }
}

Go testing.TB.TempDir 从固定目录切换到专属目录并完成 result.json 校验的控制台流程

运行 go test ./... 后，测试框架会在测试上下文结束时清理这个目录。这里的目录就是测试专属的隔离目录，测试代码不需要再写 os.RemoveAll，也不会把运行产物混进项目的 testdata。

目录路径应该由谁负责

让测试负责准备目录，让业务函数只接收 dir string，边界会比较干净。这样生产代码不依赖 testing 包，测试也能明确控制输入位置。若函数内部偷偷拼接固定目录，TempDir 只能掩盖问题，不能真正隔离。

在子测试和并发测试里保持隔离

表驱动测试常常会进一步使用 t.Run。每个子测试都从自己的测试对象取得目录，避免把父测试创建的路径共享给多个并发分支。

func TestWriteResultCases(t *testing.T) {
    cases := []struct {
        name  string
        value string
    }{
        {name: "empty", value: ""},
        {name: "unicode", value: "订单-上海"},
    }

    for _, tc := range cases {
        tc := tc
        t.Run(tc.name, func(t *testing.T) {
            t.Parallel()
            dir := t.TempDir()
            if err := writeResult(dir, tc.value); err != nil {
                t.Fatal(err)
            }
            got, err := os.ReadFile(filepath.Join(dir, "result.json"))
            if err != nil {
                t.Fatal(err)
            }
            if string(got) != tc.value {
                t.Fatalf("result = %q, want %q", got, tc.value)
            }
        })
    }
}