Go os.CreateTemp用模式生成可追踪临时文件的命名方法

需要临时文件时，os.CreateTemp 的关键不是手写时间戳，而是把业务线索放进 pattern：例如 import-20260920-*.jsonl 会保留导入批次和文件格式，最后一个星号由 Go 替换为随机字符串。这样既能避免并发重名，也能让日志和清理任务快速判断文件用途。

先拆开 dir、pattern 与最后一个星号

函数签名是 os.CreateTemp(dir, pattern) (*os.File, error)。dir 决定目录；传入空字符串时，Go 使用 os.TempDir() 返回的默认临时目录。pattern 只能描述文件名部分，不能把目录分隔符塞进去。

模式里的最后一个 * 是随机段的占位符。比如 report-*.csv 会得到类似 report-随机串.csv 的名称；report.csv 则会在整个名称末尾追加随机串。多个程序或 goroutine 同时创建时，CreateTemp 不会主动选择同一个文件名。

用业务前缀和后缀设计可追踪名称

可追踪不等于让随机串可预测，而是让随机串前后的稳定文本表达任务边界。建议把任务名、批次标识和格式放在固定位置，把随机部分交给标准库生成：

package main

import (
    "fmt"
    "os"
)

func main() {
    // 用批次和格式表达用途，星号位置交给 CreateTemp 生成随机段。
    f, err := os.CreateTemp("", "import-20260920-*.jsonl")
    if err != nil {
        fmt.Println("创建临时文件失败：", err)
        return
    }
    // Name 返回后续日志、交接和清理需要的完整路径。
    fmt.Println("临时文件路径：", f.Name())
    // 这个示例只负责展示命名；不再使用时要关闭并删除文件。
    _ = f.Close()
    _ = os.Remove(f.Name())
}

如果后续处理器要求扩展名，优先使用 job-*.part 或 job-*.jsonl，不要把扩展名写在星号后面再用字符串截断猜测。日志中记录 f.Name()，同时记录业务批次；不要记录随机串并把它当作永久业务 ID。

围绕 Name、Write 和 Close 管理生命周期

创建成功后，返回的文件已经以读写方式打开。通常的生命周期是：先保存路径，写入全部内容，处理写入错误，再关闭文件。这里的 Close 不能省略，因为它释放文件描述符，也让后续读取或交接拥有清晰的结束点。

package main

import (
    "fmt"
    "os"
)

func writeTempRecord(payload []byte) (path string, err error) {
    // 前缀用于日志检索，后缀让下游按格式识别文件。
    f, err := os.CreateTemp("", "sync-record-*.json")
    if err != nil {
        return "", fmt.Errorf("创建临时文件：%w", err)
    }
    path = f.Name()
    // 任何失败路径都尝试关闭并删除，避免留下半成品。
    defer func() {
        if closeErr := f.Close(); err == nil && closeErr != nil {
            err = fmt.Errorf("关闭临时文件：%w", closeErr)
        }
        if err != nil {
            _ = os.Remove(path)
        }
    }()

    // Write 返回实际写入字节数和错误，错误必须继续向上返回。
    if _, err = f.Write(payload); err != nil {
        return path, fmt.Errorf("写入临时文件：%w", err)
    }
    return path, nil
}

示例把清理放在失败分支；如果文件要交给另一个阶段继续处理，就在交接成功后由接收方承担删除责任。不要让调用方既以为函数会删除，又以为文件会永久保留。

参数与边界：命名问题通常不是随机串问题

官方实现使用独占创建语义，并在文件创建时采用 0600（受 umask 影响前）的权限。它解决的是“安全地创建一个不重名的临时文件”，不是目录生命周期管理，也不是跨机器的唯一业务编号。

常见问题

pattern 可以直接写目录吗？

不建议也不支持把路径分隔符放进 pattern。目录应通过 dir 参数传入，文件名规则留在 pattern。

为什么用了星号还要调用 Name？

星号只描述命名规则，实际随机串由运行时生成。调用 Name() 才能拿到真实路径，并把它传给后续读取、交接或清理逻辑。

关闭文件后还要删除吗？

要。Close 负责句柄生命周期，Remove 负责目录项生命周期；是否删除取决于文件是否已经完成交接。

参考：https://pkg.go.dev/os#CreateTemp。判断模式语义时，优先看官方函数文档，再结合业务前缀、后缀和清理责任设计名称。