Go os.CreateTemp 怎样按模式创建临时文件并及时清理

在测试、导出和上传处理中，临时文件最容易留下两个问题：文件名可能互相覆盖，或者业务已经结束但文件仍然留在临时目录。Go 的 os.CreateTemp 已经把随机命名和独占创建封装好了，正确用法是把“创建、写入、关闭、删除”看成同一条资源链。

官方地址：https://pkg.go.dev/os#CreateTemp

最小可靠写法如下：目录参数传空字符串时使用系统临时目录；模式中的 * 会被随机字符串替换；返回的文件需要显式关闭，文件本身仍要由调用方删除。

package main

import (
    "fmt"
    "os"
)

func main() {
    // 空目录表示使用系统临时目录，星号位置由 CreateTemp 生成随机片段。
    f, err := os.CreateTemp("", "report-*.json")
    if err != nil {
        fmt.Println("创建临时文件失败:", err)
        return
    }
    // 文件句柄和磁盘文件都需要清理，Name 返回实际生成的路径。
    defer os.Remove(f.Name())
    defer f.Close()

    if _, err := f.WriteString(`{"status":"ready"}`); err != nil {
        fmt.Println("写入临时文件失败:", err)
        return
    }
    fmt.Println("临时文件:", f.Name())
}

目录参数决定临时文件放在哪里

CreateTemp(dir, pattern) 的第一个参数是目录。传入空字符串时，Go 使用 os.TempDir() 返回的默认临时目录；传入非空目录时，该目录必须已经存在，且当前进程需要拥有创建权限。调用成功后，可以通过 f.Name() 得到完整路径。

这个 API 创建的是读写文件，默认权限是创建时的 0600（还会受系统 umask 影响）。因此它适合放置只供当前任务使用的中间内容，但不要把这个默认权限误解成“永久安全存储”或跨平台的访问策略。

模式中的星号怎样保留扩展名

模式字符串不只是一个前缀。没有星号时，随机字符串会追加到模式末尾；有星号时，最后一个星号会被随机字符串替换。因此 report-*.json 比 report.json 更适合需要按扩展名识别中间文件的场景。

func createJSONTemp(dir string) (*os.File, error) {
    // 把星号放在扩展名前，方便后续按 .json 识别文件类型。
    f, err := os.CreateTemp(dir, "report-*.json")
    if err != nil {
        return nil, fmt.Errorf("创建 JSON 临时文件: %w", err)
    }
    return f, nil
}

不要自己用时间戳或随机数拼路径再调用 os.Create 来代替它。手写方案需要同时处理并发冲突、重试和权限边界，而 CreateTemp 已经保证并发调用不会选择同一个文件。

关闭与删除要分别处理

关闭文件描述符和删除路径是两件事：Close 释放打开的文件，Remove 删除目录项。只调用其中一个，都可能留下资源或文件。简单场景可以用两个 defer；更严格的导出逻辑，则应保留写入、关闭和删除错误，尤其是关闭阶段可能暴露缓冲刷新失败。

func writeTempReport(dir string, data []byte) (err error) {
    // 先创建唯一文件，再把路径保存下来供失败清理使用。
    f, err := os.CreateTemp(dir, "report-*.json")
    if err != nil {
        return fmt.Errorf("创建报告文件: %w", err)
    }
    path := f.Name()
    // 删除动作放在最外层，确保写入或关闭失败也不会遗留文件。
    defer func() {
        if removeErr := os.Remove(path); err == nil && removeErr != nil {
            err = fmt.Errorf("删除临时文件: %w", removeErr)
        }
    }()
    if _, err = f.Write(data); err != nil {
        f.Close()
        return fmt.Errorf("写入报告: %w", err)
    }
    if err = f.Close(); err != nil {
        return fmt.Errorf("关闭报告: %w", err)
    }
    return nil
}

示例将删除错误合并到命名返回值中，但如果业务需要保留失败文件供人工排查，可以把删除策略改成“只在成功后删除”，并由定时清理任务处理失败残留。关键是先明确临时文件的生命周期，而不是无条件复制一套 defer。

单文件和多文件中间产物不要混用

只有一个中间文件时，CreateTemp 足够；需要同时生成多个文件时，更适合先用 os.MkdirTemp 创建一个专属临时目录，再把文件写入该目录，最后用 os.RemoveAll 一次清理。这样可以避免只删除主文件，却忘了旁边的索引、分片或元数据。

func makeWorkDir() (string, error) {
    // 多个中间文件共享一个随机目录，删除时可以统一处理。
    dir, err := os.MkdirTemp("", "job-*")
    if err != nil {
        return "", fmt.Errorf("创建工作目录: %w", err)
    }
    // 调用方拿到目录后负责 RemoveAll，里面的文件也会一起清理。
    return dir, nil
}

如果临时文件要被另一个进程读取，不要默认它会一直存在：当前进程关闭文件并删除路径后，另一个进程可能再也打不开。此时应把“交接完成后谁删除”写进接口约定，必要时使用明确的持久化目录。

几个容易忽略的边界

• 目录不存在、无写权限或磁盘不可用时，创建会返回错误，不能只检查返回的文件指针。
• 关闭成功不等于业务已经完成；要把文件路径交给下游后再决定删除时机。
• 临时文件适合中间结果，不适合作为重启后仍需存在的唯一副本。
• 若需要目录级隔离，优先使用 MkdirTemp，不要自己拼接随机目录名。

最后的判断

把 os.CreateTemp 用好，核心不是记住一个函数签名，而是同时处理三个决定：目录由谁控制、模式是否需要扩展名、清理责任落在谁身上。单文件场景用唯一文件名并保存 Name()，写完关闭后按约定删除；多文件场景则用临时目录统一收口。这样既能避免并发覆盖，也能让失败路径有明确的资源归属。

相关问题

CreateTemp 会自动删除文件吗？

不会。官方文档明确把删除责任交给调用方，通常在确定不再需要时调用 os.Remove。

为什么模式要写成 name-*.json？

星号位置会被随机字符串替换，扩展名仍保持在末尾，便于工具按文件类型识别。

什么时候应该使用 MkdirTemp？

当一个任务需要多个临时文件、分片或索引时，用临时目录统一管理和清理更稳妥。