Go testing.T TempDir让临时目录随测试自动回收的使用方法

测试要落盘时，最容易留下的不是断言错误，而是临时目录清理责任被散落在多个分支里。Go 的 testing.T.TempDir 适合把这件事收回测试生命周期：调用一次就得到一个测试专属目录，测试和它的所有子测试结束后由测试框架自动删除。这样正文只需要关注文件内容和业务断言，清理动作不再依赖某个 defer 是否被提前返回。

把 t.TempDir() 当成测试作用域内的资源入口；目录可以直接交给文件读写代码，但打开的文件、子进程等独立资源仍要由测试显式关闭。

用 t.TempDir() 接管临时目录生命周期

最小用法只有一行。目录路径是普通字符串，可以传给 filepath.Join、os.WriteFile 或被测函数。示例把配置内容写入临时目录再读回，断言关注的是结果，而不是目录什么时候删除。

func TestConfigFile(t *testing.T) {
    // 目录归当前测试作用域管理，测试及子测试完成后自动清理。
    dir := t.TempDir()
    path := filepath.Join(dir, "config.json")

    // 写入测试输入；权限参数只针对这个临时文件。
    want := []byte(`{"mode":"test"}`)
    if err := os.WriteFile(path, want, 0o600); err != nil {
        t.Fatalf("写入配置文件失败: %v", err)
    }

    // 读取并断言业务结果，避免把清理逻辑混进断言分支。
    got, err := os.ReadFile(path)
    if err != nil {
        t.Fatalf("读取配置文件失败: %v", err)
    }
    if string(got) != string(want) {
        t.Fatalf("配置内容不一致: got %s", got)
    }
}

TempDir 自 Go 1.15 加入 testing.T。官方文档还明确了两个容易被忽略的边界：同一个测试中多次调用会得到不同目录；目录创建失败时会以测试失败方式终止。不要把返回路径保存到测试函数之外继续使用，清理完成后它就不再是可靠资源。

把清理责任和业务断言分开

手写 os.MkdirTemp 时通常还要配套 defer os.RemoveAll。这在简单测试里能工作，但遇到多个返回分支、嵌套子测试或清理动作被重复封装时，维护成本会迅速上升。使用 t.TempDir() 后，目录生命周期交给测试框架，测试代码只保留必要的资源关闭。

一个实用判断是：只要资源是目录及其下的普通文件，优先让 TempDir 管；如果资源有自己的生命周期，例如文件描述符、数据库连接、子进程或后台 goroutine，就在测试中显式收尾。尤其在 Windows 环境，文件仍被打开时删除目录可能失败，先关闭句柄更稳妥。

子测试和并行测试要保持目录隔离

每个子测试内部调用一次 t.TempDir()，就能获得自己的工作目录。不要在父测试中创建一个目录，然后让并行子测试共享同名文件；那样即使目录最终会被清理，也仍然存在写入覆盖和断言互相影响的问题。

func TestProfiles(t *testing.T) {
    cases := []struct {
        name string
        data string
    }{
        {name: "basic", data: "basic"},
        {name: "admin", data: "admin"},
    }

    for _, tc := range cases {
        tc := tc // 让并行子测试捕获当前用例副本。
        t.Run(tc.name, func(t *testing.T) {
            t.Parallel()

            // 每个分支拥有独立目录，避免并行写入互相覆盖。
            dir := t.TempDir()
            path := filepath.Join(dir, "profile.txt")
            if err := os.WriteFile(path, []byte(tc.data), 0o600); err != nil {
                t.Fatalf("写入用例文件失败: %v", err)
            }
        })
    }
}

这里的关键不是“并行一定要用 TempDir”，而是目录的归属要和测试边界一致。若多个子测试确实要验证共享目录语义，就在父测试中明确创建共享目录，并把并发访问当作被测条件；不要把偶然共享误认为隔离方案。

发布前检查：GOTMPDIR、失败处理和资源占用

把 TempDir 接入测试前，可以按下面的清单检查。GOTMPDIR 适合在磁盘空间、容器挂载或权限策略有要求时调整临时目录根位置，但它不等于“关闭自动清理”。

• 目录用途是否只存在于当前测试和子测试生命周期内？
• 是否每次调用 TempDir 都接受唯一目录，而不是拼接固定共享路径？
• 文件、连接、进程和 goroutine 是否在测试返回前各自完成关闭或停止？
• CI 中的 GOTMPDIR 是否可写，并且不会把敏感测试数据落到不该持久化的位置？

如果创建临时目录失败，TempDir 会直接让测试失败，不适合用普通 error 分支继续执行。真正需要人工判断的是目录之外的资源：目录会自动收回，但资源句柄和后台工作不会因此自动消失。

相关问题

t.TempDir 每次调用都会创建新目录吗？

会。官方文档规定同一个测试中后续调用返回唯一目录，适合把不同资源组分开管理。

子测试结束后父测试还能使用父目录吗？

如果目录由父测试的 t.TempDir() 创建，父测试仍可在子测试完成后使用它，清理边界跟随创建它的测试作用域。若目录由子测试创建，子测试结束后就不应再依赖它。

TempDir 能代替文件 Close 或进程停止吗？

不能。它只负责测试临时目录的创建与清理；文件句柄、数据库连接、子进程和 goroutine 仍需按各自生命周期关闭、等待或停止。