最常用安全方式是os.WriteFile（小文件）或os.OpenFile+io.WriteString（追加/大文件）；前者覆盖写、自动关文件，后者需手动Close且支持追加；JSON用json.Marshal+WriteFile；大文件用bufio.Writer缓冲。
Go 写入文件最常用、最安全的方式是用 os.WriteFile（适合小文件一次性写入）或 os.OpenFile + io.WriteString/fmt.Fprintln（适合追加、分块、大文件场景）。别直接用 os.Create 后裸写，容易丢数据或权限出错。
用 os.WriteFile 一次性写入字符串或字节
这是最简洁的方式，底层自动处理文件创建、写入、关闭和错误返回。它会**覆盖**原文件内容，且默认权限是 0644（Linux/macOS 下等价于 -rw-r--r--），Windows 忽略权限位。
- 如果目标路径的父目录不存在，会报
no such file or directory错误，需提前用os.MkdirAll创建 - 不支持追加；要追加必须换其他方式
- 写入内容是
[]byte，字符串需转成[]byte(s)
err := os.WriteFile("output.txt", []byte("hello world\n"), 0644)
if err != nil {
log.Fatal(err)
}
用 os.OpenFile 控制打开模式与权限
当需要追加、只写不创建、或精确控制文件权限/标志位时，必须用 os.OpenFile。它比 os.Create 更底层、更灵活，也更容易踩坑。
-
os.O_WRONLY | os.O_CREATE | os.O_APPEND是追加写的标准组合 -
os.O_TRUNC会清空文件（覆盖写），和os.WriteFile行为一致 - 权限参数在 Windows 上无效；Linux/macOS 下若传
0600，新文件就是-rw------- - 忘记调用
file.Close()会导致文件句柄泄漏，尤其在循环中写多个文件时
file, err := os.OpenFile("log.txt", os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0644)
if err != nil {
log.Fatal(err)
}
defer file.Close()
_, err = io.WriteString(file, "new line\n")
if err != nil {
log.Fatal(err)
}
写入结构体或 JSON 数据？别手动拼接
直接用 json.Marshal + os.WriteFile 最省心。手动用 fmt.Sprintf 拼 JSON 容易格式错、引号漏、字段乱序，还可能被注入恶意字段名。
-
json.MarshalIndent可加缩进，方便调试但体积略大 - 写入前建议先
json.Valid校验，避免写入半截损坏文件 - 若结构体字段没加
json:tag，默认导出（首字母大写）字段才参与序列化
data := struct{ Name string }{"gopher"}
b, _ := json.Marshal(data)
os.WriteFile("config.json", b, 0644)
大文件写入或频繁写日志？注意缓冲和同步
直接对文件句
WriteString 效率低，系统调用太频繁。这时应该包一层 bufio.Writer，并按需调用 Flush。
-
bufio.NewWriterSize(file, 4096)设置 4KB 缓冲区是常见选择 - 程序异常退出前没
Flush，最后几 KB 内容就丢了 - 日志场景建议用现成库如
zap或log/slog（Go 1.21+），它们内置缓冲、滚动、异步写等能力 - 用
file.Sync()强制刷盘可保数据落盘，但性能代价高，仅关键场景（如交易记录）使用
真正难的不是“怎么写进去”，而是“怎么确保写全、写对、不丢、可恢复”。权限、路径、编码、缓冲、原子性——这些细节堆在一起，才构成生产可用的文件写入逻辑。
