Golang ioutil.WriteFile写入文件教程

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)
• 内部不缓存，数据一次性写入，适合中小文件（< 100MB）；超大文件建议用 bufio.Writer + os.File

常见错误：权限值写错或漏写

新手常把 perm 写成十进制（如 644）或字符串（如 "0644"），导致文件权限异常（例如变成 ---x--x--x）。Go 要求必须是八进制字面量，前缀 0 不可省略。

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 就只是个看起来简单的函数而已。