Go os.CreateTemp 怎么创建可控前缀的临时文件

Go 里要创建“前缀可控、后半段不重名”的临时文件，直接把业务前缀放进 os.CreateTemp 的第二个参数 pattern。例如 os.CreateTemp("", "upload-") 会在系统临时目录创建一个以 upload- 开头、后接随机字符串的文件。如果还要固定扩展名，就写成 upload-*.part，最后一个星号会被随机字符串替换。

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

使用场景：上传、导出和测试文件需要可识别名称

实际项目里的临时文件通常不希望叫完全随机的一串字符。上传中转文件需要 upload- 前缀，报表导出需要 report- 前缀，测试夹具可能希望带上用例名。稳定前缀便于日志定位和按用途清理，随机段则避免多个请求或 goroutine 同时创建同名文件。

这时不要自己用时间戳拼文件名再调用 os.Create。CreateTemp 会以排他创建方式取得一个未被占用的名称，并直接返回已打开的 *os.File。官方文档也明确说明，多进程或多个 goroutine 同时调用时不会选择同一个文件。

候选写法一：直接把固定前缀放进 pattern

最短写法是让 pattern 只包含固定前缀。因为它不含星号，随机字符串会追加在整个 pattern 后面。

package main

import (
	"fmt"
	"os"
)

func main() {
	// 空目录表示使用系统临时目录，upload- 是固定前缀
	f, err := os.CreateTemp("", "upload-")
	if err != nil {
		panic(err)
	}

	// 先登记删除路径，再登记关闭句柄
	defer os.Remove(f.Name())
	defer f.Close()

	// Name 返回最终生成的完整临时文件路径
	fmt.Println(f.Name())
}

生成的文件名形态类似 upload-123456789。随机部分的具体长度和内容属于实现细节，不应由业务代码解析；业务逻辑只依赖稳定前缀即可。

候选写法二：用最后一个星号固定随机段位置

如果下游工具依赖扩展名，推荐使用带星号的 pattern，例如 export-*.csv。CreateTemp 会把最后一个 * 替换成随机字符串，星号后的内容保留为固定后缀。

package main

import (
	"os"
)

func writeCSV(data []byte) (string, error) {
	// 随机段位于 export- 与 .csv 之间
	f, err := os.CreateTemp("", "export-*.csv")
	if err != nil {
		return "", err
	}

	// 写入失败时也要关闭句柄并删除残留文件
	name := f.Name()
	if _, err := f.Write(data); err != nil {
		f.Close()
		os.Remove(name)
		return "", err
	}

	// 返回路径前先关闭，确保后续读取者能完整访问内容
	if err := f.Close(); err != nil {
		os.Remove(name)
		return "", err
	}
	return name, nil
}

这类文件名形态类似 export-123456789.csv。如果 pattern 里出现多个星号，只有最后一个会被当作随机段占位符，前面的星号会保留为普通字符。为了减少跨平台歧义，业务代码通常只放一个星号。

对比维度：pattern、目录和返回值分别控制什么

pattern 不能包含路径分隔符。目录和文件名模式必须分开传：目录放第一个参数，前缀与后缀放第二个参数。想创建到 /srv/app/tmp 时，不要把完整路径塞进 pattern，而应写成 os.CreateTemp("/srv/app/tmp", "upload-*.part")。

推荐选择：系统临时目录还是业务临时目录

文件只在当前请求或测试期间使用时，目录传空字符串最省心，Go 会使用 os.TempDir() 指向的平台默认临时目录。需要限制磁盘配额、与其他临时文件隔离，或由后台任务统一清理时，可以传业务自己的临时目录，但要先确保目录存在。

package main

import (
	"os"
	"path/filepath"
)

func createUploadPart(root string) (*os.File, error) {
	// 单独建立业务临时目录，权限应用系统 umask 后生效
	tmpDir := filepath.Join(root, "tmp", "uploads")
	if err := os.MkdirAll(tmpDir, 0o700); err != nil {
		return nil, err
	}

	// 目录与文件名模式分开传入，便于跨平台处理路径
	return os.CreateTemp(tmpDir, "upload-*.part")
}

CreateTemp 创建文件时使用 0o600 模式（应用 umask 之前），默认只让当前用户读写。它返回的文件已经处于打开状态，可直接调用 Write、Read 或 Seek，无需再次打开。

目录、句柄和清理责任怎么选

Close 和 Remove 解决的是两个不同问题：前者释放打开的文件描述符并完成缓冲写入，后者删除磁盘上的目录项。只调用 Close 不会删除临时文件；只调用 Remove 也不代表已经正确关闭句柄。跨平台代码应显式做好两件事。

func processPayload(payload []byte) (err error) {
	// 创建带业务前缀和固定后缀的临时文件
	f, err := os.CreateTemp("", "payload-*.bin")
	if err != nil {
		return err
	}
	name := f.Name()

	// 函数退出时删除临时路径，避免长期积累
	defer func() {
		if removeErr := os.Remove(name); err == nil && removeErr != nil {
			err = removeErr
		}
	}()

	// 写入错误时先关闭句柄，再把原始错误返回
	if _, err = f.Write(payload); err != nil {
		f.Close()
		return err
	}

	// 正常路径显式关闭，让关闭错误能被调用方看到
	if err = f.Close(); err != nil {
		return err
	}

	// 在临时文件仍存在时完成后续处理
	return consumeFile(name)
}

上面的完整模式适合“函数内部创建、使用、删除”的短生命周期文件。如果要把路径返回给调用者，就不要在当前函数里 defer os.Remove，而应把删除责任写进函数契约，或者返回一个明确的清理函数。

不适用情况：为什么不建议手工拼随机名

有些代码用 time.Now().UnixNano() 或随机数拼接后，再调用 os.Create。这种做法把“生成名字”和“排他创建”拆成两个动作，容易留下检查后再创建的竞争窗口，也要求业务自己处理重名与权限。CreateTemp 已经把随机命名和排他创建封装在一起，更适合临时文件。

但 CreateTemp 也不是所有场景的答案。需要完全固定文件名并覆盖旧文件时，应该选 os.Create 或 os.OpenFile；需要在隔离目录中生成多个相关文件时，先用 os.MkdirTemp 创建临时目录更清晰。

决策表：CreateTemp、Create 和 MkdirTemp 怎么选

相关问题

pattern 里没有星号会怎样？

随机字符串会直接追加到 pattern 末尾。因此 cache- 能得到稳定的 cache- 前缀，但无法保留随机段之后的固定扩展名。

可以从临时文件名里解析随机编号吗？

不建议。随机段是避免冲突的实现细节，不是业务 ID。需要关联请求时，应在业务数据中保存自己的 ID，而不是解析文件名。

目录传空字符串是否等于当前目录？

不是。空字符串表示使用 os.TempDir() 返回的系统默认临时目录。要创建在当前目录，应显式传 "."，但生产代码通常更适合专用临时目录。

为什么关闭后文件还在？

Close 只关闭句柄，临时文件不会自动删除。官方文档把删除责任交给调用者，需要在合适的生命周期调用 os.Remove(f.Name())。

总结：控制 Go 临时文件前缀的关键不是手工拼完整文件名，而是正确使用 os.CreateTemp 的 pattern。用 prefix- 保留前缀，用 prefix-*.suffix 同时固定后缀；目录单独放在第一个参数里。创建成功后，记得区分文件句柄与磁盘路径，分别完成 Close 和 Remove。