Go语言TempFile使用详解

本文详解了Go语言中临时文件创建的正确实践，重点强调自Go 1.16起必须使用`os.CreateTemp`替代已彻底移除的`ioutil.TempFile`，并深入剖析其参数规范（`dir`与含`*`的`pattern`）、默认行为（自动打开、0600权限）、常见陷阱（漏写星号、重复打开、路径构造错误）及并发注意事项；同时对比介绍了需自定义权限或延迟打开时的替代方案（`os.MkdirTemp`+`os.OpenFile`），帮助开发者避开升级雷区、写出健壮可靠的临时文件处理代码。

ioutil.TempFile 在 Go 1.16+ 已被弃用，直接使用 os.CreateTemp —— 这是当前唯一推荐方式，旧代码升级时必须改。

为什么不能继续用 ioutil.TempFile

Go 1.16 开始，ioutil 包整体被移入 io 和 os，其中 ioutil.TempFile 的功能完全由 os.CreateTemp 承接。继续保留旧导入会触发编译错误：undefined: ioutil.TempFile。

• Go 1.15 及更早：可用，但已标记为 deprecated
• Go 1.16+：ioutil 包不存在，必须切换
• 行为上二者几乎一致，但 os.CreateTemp 参数顺序更合理（先 dir 后 pattern）

os.CreateTemp 基本用法与参数含义

签名是 func CreateTemp(dir, pattern string) (f *os.File, err error)，关键点在于：

• dir：临时目录路径，传空字符串 "" 表示使用系统默认（os.TempDir()）
• pattern：文件名模板，必须包含至少一个 "*"，会被替换成随机字符串（如 "myapp-*.log"）
• 返回的 *os.File 已打开（可读写），且权限默认为 0600（仅当前用户可读写）

tmpFile, err := os.CreateTemp("", "backup-*.json")
if err != nil {
    log.Fatal(err)
}
defer os.Remove(tmpFile.Name()) // 记得清理
defer tmpFile.Close()

_, _ = tmpFile.WriteString(`{"data":"example"}`)

常见错误和兼容性注意点

实际写代码时容易卡在这几个地方：

• 传错 pattern：漏掉 "*"（如 "backup.json"）→ 报错 "pattern contains no asterisk"
• 忽略返回的 *os.File 已打开 → 重复 os.Open 导致 “text file busy” 或权限错误
• 在 Windows 上指定 dir 时路径末尾带反斜杠但没转义 → 字符串解析失败（建议用 filepath.Join 构造路径）
• 并发调用未加锁 → 虽然 os.CreateTemp 内部是线程安全的，但若多个 goroutine 共享同一 dir 且磁盘空间紧张，可能因竞争创建失败

替代方案：需要自定义权限或不立即打开文件时

如果明确不想一创建就打开文件，或需要非 0600 权限（比如让其他进程可读），就不能用 os.CreateTemp，而应组合使用 os.MkdirTemp + os.OpenFile：

dir, err := os.MkdirTemp("", "myapp-*")
if err != nil {
    log.Fatal(err)
}
defer os.RemoveAll(dir)

filePath := filepath.Join(dir, "config.yaml")
f, err := os.OpenFile(filePath, os.O_CREATE|os.O_WRONLY, 0644)
if err != nil {
    log.Fatal(err)
}
defer f.Close()

这种写法更灵活，但多了两步操作，日常临时文件场景优先选 os.CreateTemp。

真正容易被忽略的是：临时文件名里的随机段长度固定为 10 字符，且不含路径分隔符——所以别试图在 pattern 里写 "subdir/*.log"，它只会创建在根临时目录下，"*" 不负责路径生成。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Go语言TempFile使用详解》文章吧，也可关注golang学习网公众号了解相关技术文章。