os.writefile最适合一次性写入已知[]byte的二进制数据，需注意权限用0o644、避免字符串隐式转换；大数据量或流式场景用bufio.writer包装*os.file；结构体二进制序列化必须用encoding/binary.write；追加写入须用os.o_append标志。
用 os.WriteFile 写入二进制数据最简单
只要数据已经是 []byte 类型，os.WriteFile 就是最直接的选择。它底层调用系统 write 系统调用，不带缓冲、不换行、不编码转换，天然适合二进制写入。
常见错误是误把字符串直接传给 os.WriteFile —— 虽然编译通过（Go 允许 string 隐式转 []byte），但若字符串含 Unicode 字符（比如中文），会按 UTF-8 编码后写入，这在纯二进制场景下可能不是你想要的原始字节序列。
实操建议：
- 确保源数据是明确构造的
[]byte，例如从binary.Write、encoding/binary序列化而来，或由unsafe.Slice/reflect.SliceHeader从结构体取原始内存（需谨慎） - 权限参数别写成
0644字面量——Go 要求八进制必须加0o前缀，正确写法是0o644，否则会被解释为十进制 644（对应权限01204，极可能被拒绝写入） - 示例：
data := []byte{0x00, 0xFF, 0x7F, 0x80} err := os.WriteFile("out.bin", data, 0o644)
需要流式写入时用 os.File.Write 配合 bufio.Writer
当数据量大、或需分块生成（如加密流、网络响应体落地）、或要控制写入时机（比如写完 header 再写 body），就不能一次性 WriteFile 了。
直接对 *os.File 调用 Write 是可行的，但频繁小写入性能差；加一层 bufio.Writer 能合并系统调用，且不影响二进制内容准确性——因为 bufio.Writer 只缓存字节，不做任何解释或转义。
注意点：
-
bufio.NewWriterSize(f, size)的size建议设为 4KB–64KB，太小失去缓冲意义，太大增加延迟和内存占用 - 务必在关闭前调用
w.Flush()，否则最后一批缓存字节可能丢失 - 不要混用
bufio.Writer和底层*os.File的Write方法，会导致数据错乱 - 示例：
f, _ := os.Create("stream.bin") w := bufio.NewWriterSize(f, 32*1024) w.Write([]byte{0x01, 0x02}) w.Write([]byte{0x03, 0x04}) w.Flush() // 必须 f.Close()
写结构体二进制布局必须用 encoding/binary.Write
如果目标是把 Go 结构体按 C 风格内存布局（字段连续、无填充、指定字节序）写入文件，不能靠 json.Marshal 或 gob.Encoder——前者是文本，后者是 Go 自有格式、不跨语言。
encoding/binary.Write 才是标准方案，它严格按 binary.ByteOrder（如 binary.LittleEndian）把每个字段的底层字节原样写出，且跳过未导出字段。
容易踩的坑：
- 结构体字段必须是导出的（首字母大写），否则
binary.Write会静默忽略 - 字段类型必须是基础类型（
int32,uint64,[4]byte等）或其别名；切片、指针、map 会报binary.Write: invalid type - 没有自动对齐控制：若结构体含
int8后跟int64，binary.Write会紧挨着写，不会插入 padding，和 C 的#pragma pack(1)行为一致 - 示例：
type Header struct { Magic uint32 Length uint16 } h := Header{Magic: 0x42494E00, Length: 1024} err := binary.Write(f, binary.LittleEndian, h)
追加写入二进制文件要用 os.O_APPEND 标志
想在文件末尾添加数据（比如日志块、帧数据），不能打开再 seek 到末尾——竞态条件下可能被其他进程截断。必须用 os.OpenFile 配合 os.O_APPEND 标志，这样每次 Write 都原子地定位到当前文件尾。
关键细节：
-
os.O_APPEND和os.O_CREATE通常一起用，避免文件不存在时报错 - 不要同时指定
os.O_TRUNC，它会清空文件，和追加逻辑冲突 - 即使文件被其他进程 truncate，
O_APPEND写入仍保证落在新末尾，这是内核保证的原子性 - 示例：
f, err := os.OpenFile("log.bin", os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0o644) if err != nil { /* handle */ } f.Write([]byte{0xDE, 0xAD, 0xBE, 0xEF})
二进制写入真正难的不是语法，而是对“字节即真相”的敬畏：结构体字段顺序、大小端、padding、文件打开标志的组合效应，稍有偏差就导致读不出来或解析错位。调试时优先用 xxd 或 hexdump -C 直接看输出文件的十六进制，比猜逻辑更可靠。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
