Go os.MkdirTemp 怎样创建隔离临时目录

我在处理上传解压、临时编译产物和批量转换时，通常不会把文件直接堆到系统临时目录根下，而是先用 os.MkdirTemp 建一个独立工作区。它返回的是新目录的实际路径，目录名带随机部分；调用方拿到路径后负责使用，也负责在任务结束时清理。

官方文档：https://pkg.go.dev/os#MkdirTemp

最小可靠用法是：指定父目录或传空字符串使用系统临时目录，给出业务前缀，成功后立刻登记 defer os.RemoveAll(dir)。不要把 0700 当成可以省略清理的理由，也不要把返回路径误认为固定目录名。

先把临时目录当成一次性工作区

MkdirTemp(dir, pattern) 有两个核心输入。dir 是父目录，传空字符串时由 Go 使用 os.TempDir() 返回的默认临时目录；pattern 是目录名模板，末尾会附加随机字符串。如果模板包含 *，随机字符串会替换最后一个星号，而不是把整个模板当成路径。

创建出的目录在创建时使用 0700（还会受到 umask 影响），这使它适合放本次任务的中间文件。不过权限边界只解决“谁能访问”的一部分问题，目录是否最终消失仍由调用方负责。

用返回路径承接业务文件

下面这个小型工作区示例把“创建、使用、清理”放在一个函数里。真正的业务代码可以把 workDir 传给解压、编译或转换函数；关键点是只在没有错误时继续使用返回路径，并把删除责任固定在创建成功之后。

package main

import (
    "fmt"
    "os"
    "path/filepath"
)

func prepareWorkspace() (string, error) {
    // 空 dir 表示使用系统临时目录；前缀帮助排查残留目录的来源。
    workDir, err := os.MkdirTemp("", "golang-build-*")
    if err != nil {
        return "", fmt.Errorf("创建临时目录失败: %w", err)
    }
    // 目录创建成功后立即登记清理，避免后续步骤返回错误时留下工作区。
    defer os.RemoveAll(workDir)

    inputPath := filepath.Join(workDir, "input.txt")
    if err := os.WriteFile(inputPath, []byte("待处理内容\n"), 0o600); err != nil {
        return "", fmt.Errorf("写入临时输入文件失败: %w", err)
    }
    // 返回路径只用于演示；真实函数应返回业务结果，而不是依赖已清理的目录。
    fmt.Println("工作区:", workDir)
    return inputPath, nil
}

func main() {
    // main 负责接住错误，避免把失败误当成成功路径。
    if _, err := prepareWorkspace(); err != nil {
        fmt.Println(err)
    }
}

这里的 inputPath 只在 prepareWorkspace 生命周期内有效。函数返回后目录已经进入清理流程，所以不要把这个路径保存到全局变量，随后再期待它一直存在。若业务确实需要把结果交给函数外部，应先把结果复制到持久目录，或把“工作区生命周期”提升到更外层。

清理责任仍然在调用方

MkdirTemp 不会因为函数返回、进程继续运行或文件句柄关闭而自动删除目录。成功后可以用 defer os.RemoveAll(workDir) 兜底；如果目录里的内容需要保留，就不要删除整个工作区，而是把目标文件移动到明确的持久位置后再清理剩余内容。

我通常会把清理语句紧跟在错误判断后面，而不是等所有业务步骤写完再补。这样即使中间的输入校验、写文件或外部命令调用失败，也不会漏掉临时目录。RemoveAll 本身的错误也要根据场景决定是否记录：批处理可以记录告警，强一致的清理任务则应把它作为最终错误返回。

四个容易踩到的边界

• 父目录不存在：dir 不是递归创建参数。需要自定义根目录时，先确保父目录存在，再调用 MkdirTemp。
• 模板含路径分隔符：pattern 用于名字，不用于拼接子目录；把 work/sub-* 传进去会得到参数错误，应先创建父目录再把目录名模板单独传入。
• 不要假设固定名称：即使前缀相同，多次调用也会得到不同目录；后续代码应使用函数返回的完整路径。
• 跨平台路径：组合目录内文件时用 filepath.Join，不要手写斜杠。临时目录适合短期工作区，不适合代替缓存、上传结果或数据库。

简单判断可以归纳为：dir 决定放在哪里，pattern 决定如何辨认，返回字符串决定业务实际访问哪个目录，而清理语句决定这块空间何时结束。只要把这四件事分开，os.MkdirTemp 就不只是“随机建目录”，而是一种清晰的资源生命周期设计。

相关问题

os.MkdirTemp 和 os.CreateTemp 有什么区别？前者返回目录路径，适合容纳多个中间文件；后者直接创建并打开一个临时文件，返回 *os.File。

为什么创建成功后还要 RemoveAll？随机名称和 0700 只减少冲突与访问范围，不负责回收目录；清理责任仍属于创建它的调用方。