os CreateTemp 怎样把临时文件放到指定目录

想把 Go 的临时文件放到指定目录，直接把目录路径传给 os.CreateTemp 的第一个参数即可：os.CreateTemp(dir, pattern)。其中 dir 是已经存在的目录，pattern 只是文件名模板；函数会在模板中加入随机部分，返回一个已经打开、可读写的 *os.File。用完后要先关闭文件，再删除它。

第一个参数就是目标目录

CreateTemp 的签名是 func CreateTemp(dir, pattern string) (*File, error)。例如目标目录是 ./runtime-cache，可以这样写：

package main

import (
    "fmt"
    "log"
    "os"
)

func main() {
    // dir 必须是已经存在且当前进程可写的目录。
    dir := "./runtime-cache"
    file, err := os.CreateTemp(dir, "job-*.tmp")
    if err != nil {
        log.Fatal(err)
    }

    // Name 返回系统实际创建出的完整路径，包含随机部分。
    fmt.Println(file.Name())

    // 示例结束前关闭句柄；删除动作在后面的完整写法中统一登记。
    if err := file.Close(); err != nil {
        log.Fatal(err)
    }
}

这里的关键是参数位置：dir 只负责决定文件落在哪个目录，pattern 负责生成文件名。文件名不会严格等于 job-*.tmp，最后一个星号会被随机字符串替换，因此多个并发调用不会主动选择同一个新文件名。

目录不存在时，先决定由谁创建它

CreateTemp 会在给定目录中创建文件，但不会因为父目录不存在就自动创建整棵目录树。目录是应用配置的一部分时，通常在调用前显式执行 os.MkdirAll；如果目录不存在属于配置错误，也可以直接保留错误并让调用方修正。

package main

import (
    "fmt"
    "log"
    "os"
)

func main() {
    dir := "./runtime-cache/jobs"

    // 只为这个示例创建缺失的父目录；目录已存在时 MkdirAll 不报错。
    if err := os.MkdirAll(dir, 0o750); err != nil {
        log.Fatal(err)
    }

    file, err := os.CreateTemp(dir, "payload-*.bin")
    if err != nil {
        log.Fatal(err)
    }
    defer file.Close() // 兜底关闭句柄，主要错误仍应在显式 Close 时处理。

    if _, err := file.Write([]byte("temporary payload")); err != nil {
        log.Fatal(err)
    }
    fmt.Println("created:", file.Name())
}

权限参数属于目录创建策略，不是 CreateTemp 的参数。本文只关心目录是否可用；在实际项目中，目录权限还要结合运行用户和部署环境决定。

写完以后要同时安排 Close 和 Remove

临时文件的生命周期至少有两个动作：关闭文件描述符，以及从目录中移除文件。仅调用 Close 只能释放句柄，文件本身仍可能留在磁盘上；仅调用 Remove 也不能替代对打开句柄的明确管理。

package main

import (
    "fmt"
    "log"
    "os"
)

func createPayload(dir string) (string, error) {
    file, err := os.CreateTemp(dir, "payload-*.tmp")
    if err != nil {
        return "", err
    }

    // 文件名确定后立即登记删除，后续写入失败也能进入清理路径。
    name := file.Name()
    defer func() {
        _ = os.Remove(name) // 清理失败应交给上层日志或监控处理。
    }()

    if _, err := file.WriteString("temporary data"); err != nil {
        _ = file.Close() // 返回写入错误前先尽力释放句柄。
        return "", err
    }
    if err := file.Close(); err != nil {
        return "", err
    }

    return name, nil
}

func main() {
    name, err := createPayload("./runtime-cache")
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println("created and cleaned:", name)
}

这个例子把 Remove 放在文件名确定之后，因此创建成功但写入失败时也有机会清理。显式调用 Close 可以让关闭错误出现在返回值里；函数级 defer 负责兜底关闭时，则不应再把它当成唯一的错误报告位置。

pattern 怎么写才不容易误解

pattern 是文件名模板，不是路径。把目录分隔符写进模板会让意图变得不清晰，也可能直接返回错误。需要扩展名时，可以把星号放在扩展名前：

file, err := os.CreateTemp("./runtime-cache", "report-*.json")
if err != nil {
    // 创建失败时没有可关闭的文件，直接返回错误即可。
    return err
}
defer file.Close() // 只在当前示例中演示句柄兜底关闭。

如果不写星号，Go 仍会把随机字符串追加到模板末尾。官方实现会拒绝包含路径分隔符的模板；因此应该把目录独立传给第一个参数，把文件名形状独立传给第二个参数。

需要多个文件时，改用 MkdirTemp 做目录级隔离

如果一次任务会产生多个中间文件，逐个创建在固定目录里容易留下难以归属的文件。此时可以先创建一个随机临时目录，再用 filepath.Join 生成目录内文件名，任务结束时统一 RemoveAll。

package main

import (
    "os"
    "path/filepath"
)

func prepareWorkspace() (string, error) {
    dir, err := os.MkdirTemp("./runtime-cache", "job-*")
    if err != nil {
        return "", err
    }

    // 目录创建成功后立即登记递归清理，避免中途错误留下半成品。
    defer func() {
        _ = os.RemoveAll(dir)
    }()

    input := filepath.Join(dir, "input.dat")
    if err := os.WriteFile(input, []byte("temporary input"), 0o600); err != nil {
        return "", err
    }
    return input, nil
}

这里的 RemoveAll 清理的是整个临时目录，适合目录内容完全由当前任务创建的场景。若目录由多个任务共享，就不要把共享目录传给 RemoveAll，而应继续使用单文件的 Remove。

常见误区与速查

可以把这套判断压缩成一句话：单个临时文件用 CreateTemp(dir, pattern)，记住关闭和删除；一组临时文件用 MkdirTemp，记住目录边界和 RemoveAll。只要目录、句柄和清理责任分别管理，临时文件就不会变成隐形的磁盘垃圾。

相关问题

dir 传空字符串会怎样？

空字符串表示使用 Go 通过 os.TempDir 提供的默认临时目录。若程序需要把文件放在项目缓存目录、测试工作区或指定挂载点，应显式传入目标目录。

创建的文件权限是多少？

CreateTemp 创建文件时使用 0600（再受 umask 影响），因此默认只允许创建者读写。目录本身仍需具备可访问权限。

什么时候用 MkdirTemp 而不是 CreateTemp？

只需要一个临时文件时用 CreateTemp；一次任务会产生多个互相关联的中间文件，或者需要把任务产物整体隔离时，用 MkdirTemp 更容易统一清理。