os.CreateTemp是Go 1.16+唯一推荐方式,ioutil.TempFile已彻底移除;第二个参数必须且仅能含一个*作为随机占位符,不可在路径中使用,否则生成错误文件名;dir应显式指定可信路径而非空字符串,避免TMPDIR劫持;权限须用Go 1.19+三参数版本原子设置,禁用事后chmod;清理需defer func(){os.RemoveAll(dir)}()确保panic时也执行。

os.CreateTemp 是 Go 1.16+ 唯一推荐的临时文件创建方式,ioutil.TempFile 已彻底移除;不显式指定目录、漏写 *、事后 chmod 都会埋下安全或竞态隐患。
为什么 os.CreateTemp(dir, pattern) 第二个参数必须带 *
它不是 glob 匹配符,而是唯一性占位符:Go 用随机字节替换 * 来避免命名冲突。不写会 panic 报 pattern contains no asterisk;写两个会报 pattern contains multiple *s;写成 "log.txt" 或 "log.*.txt" 都非法。
-
os.CreateTemp("", "app-*.log")✅ 生成类似/tmp/app-aB3f9.log -
os.CreateTemp("", "app.log")❌ panic -
os.CreateTemp("", "app-*.log.*")❌ panic(多个*) -
os.CreateTemp("", "app-*.log")中的*不可出现在路径部分,如"subdir/*.log"会在当前目录创建字面名为subdir/*.log的文件,不是子目录
如何安全指定 dir 参数,避开 TMPDIR 环境变量陷阱
传空字符串 "" 看似方便,实则让 os.CreateTemp 调用 os.TempDir(),而该函数受 TMPDIR 环境变量控制——攻击者可伪造该变量,把临时文件导向任意可写路径(比如软链到 /etc/)。生产环境必须显式指定可信目录。
- 推荐用
filepath.Join("/var/tmp", "myapp")构造私有目录,并提前os.MkdirAll(dir, 0755) - 容器或 CI 环境中,
os.TempDir()可能返回空或不可写路径,显式检查比依赖 fallback 更可靠 - Windows 下目录必须已存在,
os.CreateTemp不会自动创建父目录;Linux/macOS 同样要求dir存在且进程有写权限,否则直接报no such file or directory
权限怎么设才不踩竞态坑:别用 os.Chmod,用第三个参数
默认权限是 0600(仅属主读写),安全但有时需共享读取(如日志被外部工具 tail)。错误做法是创建后再 os.Chmod(file.Name(), 0644)——中间存在竞态窗口,其他进程可能在此期间读取或篡改文件。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
立即学习“go语言免费学习笔记(深入)”;
- Go 1.19+ 支持三参数版本:
os.CreateTemp(dir, pattern, 0644),权限在原子创建时即生效 - 跨平台项目慎用
0666:Linux 受 umask 影响,Windows 不强制执行,统一用0600或按runtime.GOOS分支判断 - 不要为了“省事”设
0666,尤其在多用户系统上,这等于主动开放敏感临时数据
清理逻辑必须覆盖 panic 和早期 return,别只靠 defer os.Remove
os.CreateTemp 返回的是已打开的 *os.File,但它不会自动删除。残留文件不仅占磁盘,还可能泄露调试数据或凭证。单纯 defer os.Remove(f.Name()) 在 f 被重赋值、或 Write 失败后提前 return 时可能删错路径或静默失败。
- 临时目录必须用
os.RemoveAll,且包裹为defer func() { os.RemoveAll(dir) }(),确保 panic 时也触发 - 临时文件若在写入中途出错,应立即
os.Remove并 return,不能等 defer - 永远不要对
os.TempDir()根目录调用os.RemoveAll,它被全系统共享
最易被忽略的是:临时文件名里的 * 不是语法糖,是原子性保障的核心;而清理不是“最好做”,是“不做就留后门”。

















