只有指定 os.o_append 才能实现原子追加,否则并发写可能覆盖;追加前应校验魔数;write 在无错时必返回完整长度,须检查错误和返回值。

Go 中用 os.OpenFile 以 os.O_APPEND 模式写入才真正追加
直接用 os.Create 或 os.OpenFile 不带 os.O_APPEND 标志写文件,哪怕 Seek 到末尾,也**不是原子追加**,多协程或并发写时可能覆盖。只有打开时明确指定 os.O_APPEND,内核才会在每次 Write 前自动定位到当前文件末尾——这是 POSIX 保证的原子行为。
常见错误是先 os.Stat 获取长度再 file.Seek(size, 0),这中间存在竞态窗口;或者误以为 os.O_WRONLY | os.O_CREATE 就能追加。
-
os.O_APPEND必须和os.O_WRONLY或os.O_RDWR同时使用,单独用会失败 - 如果文件不存在,
os.O_CREATE要一并传入,否则打开失败 -
os.O_APPEND会忽略所有Seek调用,Write总是从末尾开始
file, err := os.OpenFile("data.bin", os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0644)
if err != nil {
log.Fatal(err)
}
defer file.Close()
_, err = file.Write([]byte{0x01, 0x02, 0x03})
二进制数据追加前要不要校验文件头或魔数
如果你的“追加”是向自定义二进制格式(比如日志块、序列化记录)中添加新条目,**强烈建议在追加前做轻量校验**,而不是无条件写入。否则损坏的文件头可能导致后续解析完全失败,且无法区分是截断还是脏写。
典型做法:打开文件后,读取前几个字节(如 4–8 字节),比对预期魔数(magic number)或版本标识。不匹配就拒绝追加,或按策略重建/报错。
- 只读前 N 字节,用
io.ReadFull配合bytes.Equal判断,避免部分读导致误判 - 不要用
os.O_TRUNC清空重来——这会丢失已有数据 - 若需兼容旧版本格式,可在此处分支处理,但魔数校验本身应保持最小侵入
Write 返回值不等于输入长度?那是 I/O 错误或磁盘满
Go 的 Write 方法返回实际写入字节数和错误。对普通磁盘文件,只要没出错,它**总是返回 len(p)**(即你传入切片的长度)。如果返回值小于预期,说明发生了真实 I/O 问题,比如磁盘空间不足、权限变化、文件系统只读等。
很多人忽略这个返回值,结果数据静默截断却毫无察觉。尤其在嵌入式或边缘设备上,磁盘满是高频问题。
- 必须检查
err != nil,且当n 时视为写入失败(即使 <code>err == nil,这种情况极罕见但理论上 POSIX 允许) - 不要用
fmt.Println打印二进制数据调试——用hex.Dump或fmt.Printf("%x", data) - 大块二进制追加时,考虑分批写入 + 每次检查,避免单次超长阻塞或内存暴涨
Windows 下追加二进制文件要注意 \r\n 自动转换陷阱
在 Windows 上,如果用 os.O_TEXT(极少用,Go 标准库默认不启用),或通过某些封装层(如旧版 ioutil)间接触发文本模式,\n 可能被转成 \r\n,破坏二进制完整性。但 Go 的 os 包底层始终以二进制模式操作,**只要你没手动包装 bufio.Writer 并设置换行符,就不会发生转换**。
真正要防的是:把二进制文件误当成文本打开、用 fmt.Fprintln 写、或用 strings.ReplaceAll 处理原始字节流。
- 永远用
[]byte和Write,不用.WriteString处理非 UTF-8 数据 - 确认你的构建环境没有启用 CGO 并链接了非标准 C 库(极少见,但某些交叉编译场景可能)
- 跨平台部署时,用
runtime.GOOS做路径分隔符适配即可,二进制 I/O 行为一致
os.O_APPEND 是唯一可靠的起点,其余都得靠你自己的协议层兜底。golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











