Go os.CreateTemp 如何按业务前缀生成临时文件

在 Go 里，想按业务前缀创建临时文件，直接使用 os.CreateTemp(dir, pattern)。例如传入 "invoice-*.json"，返回的文件名会保留 invoice- 和 .json，把最后一个星号替换成随机字符串；传入空目录则使用 os.TempDir() 返回的系统临时目录。真正容易遗漏的是生命周期：创建成功后，调用方既要处理 Close，也要在文件不再需要时调用 os.Remove。

业务前缀只负责让临时文件可识别，唯一性由 CreateTemp 的随机部分保证；把文件名保存下来，并用 defer 兜底删除，才能覆盖写入失败和提前返回。

官方参考：https://pkg.go.dev/os#CreateTemp

os.CreateTemp 的前缀规则：星号决定随机串放在哪里

函数签名是 os.CreateTemp(dir, pattern) (*os.File, error)。它会创建文件并以读写方式打开，返回的 *os.File 已经对应一个真实路径。dir 不应由用户输入直接拼接到任意位置；服务端通常把它限定为工作目录下的缓存或交换目录。

pattern 更像“命名模板”而不是完整文件名。星号存在时，最后一个星号被随机字符串替换；没有星号时，随机字符串追加在整个 pattern 后面。因此，带扩展名的业务文件应把星号放在扩展名前：

package main

import (
    "fmt"
    "os"
)

func main() {
    // 空目录表示使用 os.TempDir；星号被替换后仍保留 .json 后缀。
    f, err := os.CreateTemp("", "invoice-*.json")
    if err != nil {
        // 创建失败时没有可关闭或可删除的文件对象，直接返回错误。
        panic(err)
    }
    defer os.Remove(f.Name()) // 业务结束后兜底删除临时文件。
    defer f.Close()           // 即使后续提前返回，也释放文件描述符。

    fmt.Println(f.Name()) // 例如 /tmp/invoice-348912.json，随机段不可预设。
}

如果希望文件名没有扩展名，可以使用 "invoice-"；如果写成 "invoice-*.json.*"，只有最后一个星号会替换，前面的星号仍是普通字符。不要根据随机字符串推断业务编号，也不要把返回路径当作可预测的公共下载地址。

关闭、读取与清理：临时文件生命周期怎么收口

创建、写入、关闭、删除是四个不同责任。Write 把数据交给文件对象，Close 释放打开的文件，Remove 删除目录项。只调用 Close 不代表文件已经从磁盘消失，只调用 Remove 也不能替代对文件对象的关闭。

一个更适合生产代码的写法是让清理动作尽早登记，再对关键错误显式返回。删除失败不能被无声吞掉，否则临时目录会逐渐堆积；但删除动作也要允许文件本来就已被上游移走：

func writeInvoice(data []byte) (string, error) {
    // 用业务前缀和后缀表达用途，目录由部署配置决定。
    f, err := os.CreateTemp("/var/lib/acme/work", "invoice-*.json")
    if err != nil {
        return "", fmt.Errorf("create temp file: %w", err)
    }
    name := f.Name()
    keep := false
    defer func() {
        // 只有明确交给后续流程时才保留文件，其余路径统一清理。
        _ = f.Close()
        if !keep {
            _ = os.Remove(name)
        }
    }()

    if _, err := f.Write(data); err != nil {
        // 返回前不手动重复清理，交给上面的 defer 处理。
        return "", fmt.Errorf("write temp file: %w", err)
    }
    if err := f.Close(); err != nil {
        // Close 失败可能意味着数据未完整落盘，不能把 name 当成功结果。
        return "", fmt.Errorf("close temp file: %w", err)
    }
    keep = true
    return name, nil
}

上例的 keep 只表示“后续流程负责接管”，并不表示永久保留。接管方仍应在上传、转换或消费完成后删除 name。若业务只需要一次读取，可在关闭后重新打开，或按平台语义先完成读取再清理，不要假设不同操作系统的删除行为完全相同。

目录、权限和并发：排查临时文件问题的检查清单

并发安全的边界是“同一时刻不会选到同一个新文件”，不是“文件内容天然线程安全”。多个 goroutine 仍然不应同时写同一个 *os.File，也要明确谁拥有删除权。空目录的便利性适合短生命周期任务；需要权限隔离、容量监控或跨进程交接时，显式传入专用目录更稳妥。

相关问题

os.CreateTemp 和 os.MkdirTemp 怎么选？

只需要一个文件时用 CreateTemp；需要多个中间文件并希望整体清理时，用 MkdirTemp 创建目录，再在目录内管理文件。

如何拿到 CreateTemp 生成的完整路径？

调用返回对象的 f.Name()。不要从 pattern 反推随机部分，实际路径以返回值为准。

关闭后还要 Remove 吗？

通常要。Close 释放文件对象，Remove 才删除目录项；两者应根据业务接管关系分别安排。