os.WriteFile 是 Go 1.16+ 安全写入文件的默认首选，覆盖写、原子性、简洁；但不创建父目录、需手动处理权限与错误，大文件应改用流式写入。
os.WriteFile 是当前 Go（1.16+）中安全写入文件的默认选择，它覆盖、原子、简洁，且无需手动管理文件句柄。
用 os.WriteFile 写小到中等字节数组（≤100MB）
这是绝大多数场景下的首选，比如保存配置、API 响应、模板渲染结果等。
- 函数签名是
os.WriteFile(filename string, data []byte, perm fs.FileMode) error，三个参数都不可省略 - 权限必须传
fs.FileMode类型，但可直接写0644或0600，Go 会自动转换；Windows 忽略权限位，但建议仍按惯例传入以保持跨平台一致性 - 它内部先写临时文件再
os.Rename，在 POSIX 系统上具备原子性——进程崩溃不会留下半截文件 - 若目标路径含多级目录（如
"logs/2026/09/app.log"），os.WriteFile不会自动创建父目录，需提前调用os.MkdirAll(filepath.Dir(filename), 0755) - 错误必须检查：磁盘满、路径非法、权限不足、父目录不存在都会返回非 nil 错误，忽略会导致静默失败
大文件或流式写入（>100MB 或需控制内存）
直接传超大 []byte 给 os.WriteFile 会触发高内存峰值，甚至 OOM。此时应切换为流式写入。
- 用
os.Create或os.OpenFile获取*os.File，再配合io.Copy（如从bytes.Reader或网络响应体） - 务必用
defer f.Close()，否则文件句柄泄漏；os.Create默认是O_TRUNC | O_CREATE | O_WRONLY，行为与os.WriteFile一致 - 若需追加写入（而非覆盖），不能用
os.WriteFile，必须用os.OpenFile(filename, os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644) - 对性能敏感场景（如高频日志），可套一层
bufio.Writer，但要注意：未Flush()或Close()会导致数据滞留在缓冲区，丢失风险高
并发写入同一文件时避免交错
多个 goroutine 直接共用一个 *os.File 并调用 Write 或 WriteString，即使加锁也难保每行完整——Write 本身不保证原子性，系统调用可能被中断或调度打乱。
- 正确做法是用 channel 将所有写请求发给单个“写入服务 goroutine”，由它串行处理；这是 CSP 范式，比互斥锁更清晰、更可靠
- 不要依赖
O_APPEND来规避竞态：它只保证每次write()追加到末尾，但若多个 goroutine 同时调用，仍可能因调度导致内容交错（例如两行日志混成一行） - 若必须多协程写不同文件，确保每个文件由独立 goroutine 独占，或使用
sync.Pool复用*os.File实例（仅限只读或固定生命周期写入）
权限和路径安全常被忽略的细节
权限设错或路径没校验，轻则功能异常，重则引发安全漏洞。
立即学习“go语言免费学习笔记（深入）”；
- 敏感文件（如密钥、token）必须用
0600，0644在多用户环境等于公开 - 文件名来自用户输入时，必须过
filepath.Clean()并做白名单校验（如只允许字母、数字、下划线、点），否则"../../etc/passwd"可能导致目录穿越 -
os.WriteFile不支持设置 ACL（Windows）或扩展属性（Linux），如需细粒度控制，得用os.Chmod或调用系统命令（不推荐） - 写入后若需立即落盘（如关键日志），应调用
f.Sync()，但注意这会显著降低吞吐量，慎用
