正确姿势是用os.OpenFile配合os.O_APPEND|os.O_WRONLY|os.O_CREATE标志，确保原子性追加；避免单独使用O_APPEND、误加O_TRUNC或用os.Seek+Write模拟，注意并发加锁、缓冲区刷新及路径权限问题。
Go 中用 os.OpenFile 追加写入文件的正确姿势
直接用 os.OpenFile 配合 os.O_APPEND | os.O_WRONLY | os.O_CREATE 标志是最稳妥、最常用的方式。它确保每次写入都自动定位到文件末尾，且不覆盖原有内容。
常见错误是只传 os.O_APPEND 却漏掉 os.O_WRONLY —— 这会导致打开失败并报错 invalid argument；或者误加 os.O_TRUNC，结果变成清空重写。
-
os.O_APPEND必须与os.O_WRONLY或os.O_RDWR同时使用，单独用会失败 - 如果文件不存在，
os.O_CREATE会自动创建；但若父目录不存在，仍会报no such file or directory - 并发写入同一文件时，
os.O_APPEND在大多数系统上能保证原子性（内核级追加），但 Go 层面仍需注意*os.File不是并发安全的，多个 goroutine 共享同一个*os.File实例必须加锁
file, err := os.OpenFile("log.txt", os.O_APPEND|os.O_WRONLY|os.O_CREATE, 0644)
if err != nil {
log.Fatal(err)
}
defer file.Close()
_, err = file.WriteString("new line\n")
if err != nil {
log.Fatal(err)
}
为什么不用 os.Seek + os.Write 模拟追加
有人试图先 os.Stat 获取文件大小，再 os.Seek(file, 0, io.SeekEnd)，最后 Write —— 这种方式在单次写入时看似可行，但存在竞态风险：两个 goroutine 同时读取到相同文件长度，随后写入就会相互覆盖。
而 os.O_APPEND 是由内核保证“定位+写入”为原子操作，无需用户干预位置，也规避了时间窗口问题。
立即学习“go语言免费学习笔记（深入）”；
damishop介绍 大米外贸商城系统 简称damishop 完全开源版，只需做一种语言一键开启全球133中语言自动翻译功能，价格实现自动汇率转换,集成微信支付宝 paypal以及国外主流支付方式，自带文章博客系统,首创支持可视化编辑。 软件架构 基于MVC+语言包模式,增加控制台，API导入产品方便对接其他系统（带json示例数据）。 使用要求
-
os.Seek+Write在多进程/多 goroutine 场景下不可靠，尤其当写入频繁或文件被其他程序同时修改时 - 即使加锁模拟追加，性能也不如原生
O_APPEND，还增加出错概率 - Windows 下
Seek到io.SeekEnd的行为与 Unix 略有差异，跨平台兼容性更差
bufio.Writer 和追加写入的配合要点
用 bufio.NewWriter 包裹 *os.File 能提升小量高频写入的性能，但要注意缓冲区刷新时机 —— 它不会自动感知 O_APPEND，所有写入仍通过底层 *os.File 发出，所以只要底层文件是以 O_APPEND 打开的，缓冲写入依然安全。
- 务必在关闭前调用
bufWriter.Flush()，否则最后一部分数据可能滞留在缓冲区未落盘 - 不要在
Flush()后继续写入已关闭的*os.File，否则会 panic：write: bad file descriptor - 若需实时日志，可考虑设置较小的缓冲区（如
bufio.NewWriterSize(file, 256)）或搭配file.Sync()强制刷盘
file, _ := os.OpenFile("app.log", os.O_APPEND|os.O_WRONLY|os.O_CREATE, 0644)
buf := bufio.NewWriterSize(file, 512)
buf.WriteString("request started\n")
buf.Flush() // 必须显式调用
file.Close()
追加写入失败的典型错误信息与排查方向
实际开发中遇到写入失败，多数不是逻辑问题，而是权限或路径问题。以下错误出现频率高，对应原因明确：
-
permission denied：目标路径所在目录无写权限，或文件本身设置了只读属性（如 Windows 的只读 flag） -
no such file or directory：路径中某一级目录不存在（O_CREATE只创建文件，不创建父目录），需提前用os.MkdirAll -
too many open files：忘记Close()导致文件描述符泄漏，尤其在循环中反复OpenFile时极易触发 -
invalid argument：标志位组合错误，例如用了O_APPEND却没配O_WRONLY，或传了非法的perm值（如负数）
追加写入本身逻辑简单，真正复杂的是路径构造、权限控制、并发安全和资源生命周期管理——这些地方出问题，比写法本身更容易导致线上故障。
