ioutil.WriteFile 在 Go 1.16+ 已被弃用，应改用 os.WriteFile；后者默认覆盖写入、权限仅在新建文件时生效，且不支持追加。
ioutil.WriteFile 在 Go 1.16+ 已被弃用，直接使用 os.WriteFile 是当前标准做法。强行沿用 ioutil.WriteFile 会导致构建失败（如果启用了 -mod=readonly 或依赖 clean 的 module 环境），且无法获得新版本的底层优化。
为什么 ioutil.WriteFile 不再可用
Go 官方在 io/ioutil 包中将所有导出函数和类型标记为“deprecated”，并在 Go 1.16 中将其移入 io 和 os 包。这不是简单的重命名——ioutil.WriteFile 的实现已完全由 os.WriteFile 接管，后者内部调用 os.OpenFile + Write + Close，并默认设置 O_WRONLY | O_CREATE | O_TRUNC 标志。
- Go 1.15 及更早：可正常使用
ioutil.WriteFile - Go 1.16+：导入
io/ioutil会触发 warning；调用ioutil.WriteFile仍能编译（若未启用-gcflags="-std=false"类严格检查），但属于技术债务 - Go 1.22+：模块校验可能直接拒绝含
io/ioutil的构建
os.WriteFile 的参数与行为细节
os.WriteFile 签名是 func WriteFile(name string, data []byte, perm fs.FileMode) error，三个参数含义明确，但容易忽略两点：
-
perm是文件权限掩码（如0644），**仅在文件新建时生效**；若文件已存在，权限不会被修改（Linux/macOS 下如此，Windows 忽略该参数） - 该函数**总是覆盖写入**（等价于
O_TRUNC），不支持追加；需追加请改用os.OpenFile(name, os.O_APPEND|os.O_WRONLY|os.O_CREATE, 0644) - 内部不缓存，数据一次性写入，适合中小文件（bufio.Writer +
os.File
常见错误：权限值写错或漏写
新手常把 perm 写成十进制（如 644）或字符串（如 "0644"），导致文件权限异常（例如变成 ---x--x--x）。Go 要求必须是八进制字面量，前缀 0 不可省略。
立即学习“go语言免费学习笔记（深入）”；
err := os.WriteFile("config.json", data, 0644) // ✅ 正确：八进制
err := os.WriteFile("config.json", data, 644) // ❌ 错误：十进制，实际权限是 01164（罕见且危险）
err := os.WriteFile("config.json", data, 0o644) // ✅ 也可，Go 1.13+ 支持 0o 前缀
另外，若目标目录不存在，os.WriteFile 会返回 no such file or directory 错误，**它不自动创建父目录**。需提前调用 os.MkdirAll(filepath.Dir(name), 0755)。
替代方案：需要原子写入或带错误上下文时
直接覆盖有风险：写入中途崩溃可能导致文件损坏或清空。生产环境推荐先写临时文件，再 os.Rename 原子替换：
tmpName := fileName + ".tmp"
err := os.WriteFile(tmpName, data, 0644)
if err != nil {
return err
}
return os.Rename(tmpName, fileName)
注意：os.Rename 在同文件系统内是原子的；跨文件系统会失败，此时需 fallback 到 io.Copy + os.Remove 组合，并接受非原子性。
权限、路径、原子性——这三个点没处理好，os.WriteFile 就只是个看起来简单的函数而已。
