在Golang中实现文件追加写入应优先使用os.OpenFile配os.O_APPEND|os.O_WRONLY|os.O_CREATE标志,适用于持续日志等场景;os.AppendFile仅适合单次小量追加。需注意并发安全(建议加锁)和Close错误处理。

在 Golang 中实现文件追加写入,核心是使用 os.OpenFile 并传入 os.O_APPEND | os.O_WRONLY | os.O_CREATE 标志,而不是用 os.AppendFile(它只适合一次性小量追加)。
使用 os.OpenFile 进行持续追加写入
这是最常用、最灵活的方式,适用于日志记录、流式写入等场景。关键在于打开文件时指定正确的 flag:
-
os.O_APPEND:每次写入自动定位到文件末尾 -
os.O_WRONLY:只写模式(追加不需要读权限) -
os.O_CREATE:文件不存在时自动创建
示例代码:
f, err := os.OpenFile("log.txt", os.O_APPEND|os.O_WRONLY|os.O_CREATE, 0644)
if err != nil {
log.Fatal(err)
}
defer f.Close()
_, err = f.WriteString("新日志行\n")
if err != nil {
log.Fatal(err)
}
使用 os.AppendFile 快速单次追加
适合写入少量内容(如一行配置、一次状态快照),内部自动处理打开/关闭,简洁但不高效——每次调用都重开文件。
立即学习“go语言免费学习笔记(深入)”;
- 底层调用
os.OpenFile+Write+Close - 不适合高频或大体积追加(比如循环中反复调用)
示例:
err := os.AppendFile("data.txt", []byte("追加的内容\n"), 0644)
if err != nil {
log.Fatal(err)
}
注意文件权限与并发安全
追加写入本身是原子的(单次 Write 调用),但多个 goroutine 同时写同一文件会导致内容交错:
- 避免多个 goroutine 直接共用一个
*os.File写入 - 如需并发写,应加锁(
sync.Mutex)或使用带缓冲的日志库(如log/slog) - Linux/macOS 下,相同 flag 打开的文件描述符可安全并发追加;但 Go 运行时未保证跨平台行为一致,建议统一加锁
错误处理与资源释放
务必检查 Write 和 Close 的返回值,尤其 Close 可能返回写入缓存失败的错误:
- 不要忽略
f.Close()的 error,它可能反映磁盘满、I/O 错误等严重问题 - 用
defer f.Close()确保关闭,但需额外捕获 close 错误(例如在函数末尾显式调用并检查) - 写入前可先用
os.Stat检查磁盘空间或权限(按需)
基本上就这些。追加写入不复杂但容易忽略 close 错误和并发风险,选对方式、做好错误处理,就能稳定可靠地记录数据。










