Go 1.16起ioutil.WriteFile被弃用，应改用os.WriteFile或os.Create+Write组合；Go 1.22+中直接报错undefined，且权限参数受umask影响，大文件易OOM，失败会清空原文件。
Go 1.16 起 ioutil 已被弃用，所有写入操作应改用 os.WriteFile 或 os.Create + Write 组合；强行用旧包会触发构建警告，且无法通过 Go 1.22+ 的 vet 检查。
为什么 ioutil.WriteFile 现在不能用了
Go 官方将 ioutil 中的函数全部迁移到 io 和 os 包，ioutil.WriteFile 对应的是 os.WriteFile。这不是“还能用但不推荐”，而是明确标记为 Deprecated —— 在 go.mod 声明 go 1.22 后，go build 会直接报错：undefined: ioutil.WriteFile。
-
ioutil.WriteFile的签名是func WriteFile(filename string, data []byte, perm fs.FileMode) error -
os.WriteFile完全一致，只是包路径变了 - 如果你还在 import
"io/ioutil"，请立刻删掉，换成"os"
os.WriteFile 的权限参数容易踩坑
第三个参数 perm 不是“仅当文件不存在时才生效”，而是直接传给底层 open(2) 的 mode，影响新建文件的权限位。在 Linux/macOS 上若设为 0644，而 umask 是 0022，最终文件权限会是 0644 &^ 0022 = 0644；但如果设成 0666，实际得到的是 0644（因为 umask 掩码生效）。Windows 忽略该参数，只保留读写标志。
- 写配置文件建议用
0644（即os.FileMode(0644)） - 写私钥或敏感临时文件建议用
0600 - 永远不要传
0777—— 即使你立刻Chmod，中间也存在竞态窗口 - 如果想“覆盖写且保持原权限”，
os.WriteFile不支持，得用os.OpenFile+Truncate+Write
大文件别硬塞 os.WriteFile
os.WriteFile 是原子性的一次性写入：它先写到临时文件，再 rename 替换原文件（Linux/macOS），或直接覆盖（Windows）。这意味着整个 []byte 必须常驻内存。写 500MB 日志？直接 OOM。
立即学习“go语言免费学习笔记（深入）”；
- 日志、导出 CSV、生成报告等场景，请用
os.Create+bufio.NewWriter - 需要确保落盘可用（如数据库 WAL），加上
w.Flush()和file.Sync() - 若需断点续传或流式加密写入，必须放弃
os.WriteFile，改用io.Copy或分块Write
file, err := os.Create("output.bin")
if err != nil {
log.Fatal(err)
}
defer file.Close()
w := bufio.NewWriter(file)
_, err = w.Write([]byte("header\n"))
if err != nil {
log.Fatal(err)
}
// ... 写入大量数据
w.Flush() // 必须调用，否则缓冲区内容可能未写出
file.Sync() // 强制刷到磁盘（可选，看业务是否要求持久化）
写入失败时，原文件可能已被清空
os.WriteFile 内部使用 os.OpenFile(..., os.O_CREATE|os.O_WRONLY|os.O_TRUNC)，也就是说：只要打开成功，就会立刻 Truncate 原文件为 0 字节。后续写入失败（比如磁盘满、权限不足），你拿到的是一个空文件，原内容已不可恢复。
- 关键配置/数据库迁移脚本中，务必先
os.ReadFile备份，或写入.tmp后os.Rename - 不要依赖 “写入失败=文件不变” —— 这个假设在
os.WriteFile下不成立 - 若需原子更新且带回滚，标准库无内置方案，需自行实现临时文件 + rename + cleanup 逻辑
真正难的不是“怎么写进去”，而是“写失败了怎么办”和“别人正在读的时候我覆盖了怎么办”。这两个问题，os.WriteFile 本身不解决，得靠上层设计兜底。
