Go语言写入文件的几种方法详解

本文深入解析了Go语言中文件写入的多种方式及其适用场景，强调安全与可靠性：小文件推荐使用简洁安全的os.WriteFile（自动覆盖、关闭和错误处理），追加或大文件则需用os.OpenFile配合io.WriteString并手动管理Close，JSON数据应通过json.Marshal序列化后写入，而高频或大体积写入务必引入bufio.Writer缓冲以提升性能并防止数据丢失；同时提醒开发者注意权限设置、目录预创建、编码一致性及关键场景下的file.Sync()强制落盘等生产级细节，真正实现“写全、写对、不丢、可恢复”的稳健文件操作。

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() 强制刷盘可保数据落盘，但性能代价高，仅关键场景（如交易记录）使用

真正难的不是“怎么写进去”，而是“怎么确保写全、写对、不丢、可恢复”。权限、路径、编码、缓冲、原子性——这些细节堆在一起，才构成生产可用的文件写入逻辑。

好了，本文到此结束，带大家了解了《Go语言写入文件的几种方法详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！