Go 的 binary.Write 不默认使用大端序；它必须显式传入 binary.BigEndian 或 binary.LittleEndian，缺省或传 nil 会编译失败或 panic，不存在隐式默认字节序。
Go 的 binary.Write 默认用大端序吗？
是的，binary.Write（以及 binary.Read）**默认使用大端序（BigEndian）**，但这个“默认”不是靠约定，而是由你传入的 binary.BigEndian 这个具体实现决定的。它本身不接受“无参数”的调用 —— 你必须显式传入一个 binary.ByteOrder 实现，比如 binary.BigEndian 或 binary.LittleEndian。没传就编译不过，不存在“隐式默认”。
常见错误是误以为写个 int32 就自动按网络字节序了，结果忘了传 binary.BigEndian，直接卡在编译报错：not enough arguments 或类型不匹配。
-
binary.Write第二个参数必须是binary.ByteOrder接口值，不能省略 - Go 标准库只提供
binary.BigEndian和binary.LittleEndian两个实现，没有“系统本地序”别名 - 如果目标协议明确要求大端（如 TCP/IP 头、PNG、gRPC wire format），就固定用
binary.BigEndian，别依赖平台
写入 struct 到 bytes.Buffer 时字段顺序和对齐怎么处理？
binary.Write 不解析 struct tag，也不做内存对齐调整 —— 它只是按字段声明顺序，依次把每个字段的底层内存表示（raw bytes）写进去。这意味着：字段顺序必须和协议定义严格一致；struct 里不能有 padding 字节；所有字段必须是可直接编码的类型（int32、uint16、[4]byte 等），不能含 string、slice、map 或指针。
例如这个 struct：
立即学习“go语言免费学习笔记（深入）”；
type Header struct {
Magic uint32
Length uint16
Flags uint8
}
用 binary.Write(buf, binary.BigEndian, hdr) 是安全的；但如果加了 unused [2]byte 或中间插了个 string，就会 panic 或写入垃圾数据。
- struct 必须是“flat”且字段类型全部支持
encoding.BinaryMarshaler或基础整数/数组类型 - 字段顺序 = 写入顺序 = 协议字节顺序，改字段名不影响，但改顺序会彻底破坏兼容性
- 如果协议要求某字段是 4 字节但 Go 里用了
int（可能为 8 字节），务必显式用int32或uint32
写入变长数据（比如带长度前缀的字符串）怎么办？
binary.Write 本身不支持变长序列，它只处理定长类型。要写“长度 + 字节数组”这种常见模式，得手动拆解：先写长度字段（用 binary.Write），再写内容字节（用 buf.Write()）。
例如写一个 2 字节长度 + UTF-8 字符串：
str := "hello" binary.Write(buf, binary.BigEndian, uint16(len(str))) // 先写大端序长度 buf.Write([]byte(str)) // 再写原始字节
反过来读的时候也一样：先用 binary.Read 读出 uint16 长度，再用 io.ReadFull 读指定字节数。
- 别试图把
string直接塞进binary.Write—— 会 panic：“binary.Write: invalid type string” - 长度字段自身的字节序必须和协议一致（通常也是大端），别混用
LittleEndian - 如果长度可能超 65535，改用
uint32并同步更新读逻辑
为什么用 binary.Write 而不用 encoding/gob 或 json？
因为 binary.Write 生成的是紧凑、无额外标记、与 C/网络协议完全对齐的原始字节流；而 gob 带类型描述头、json 是文本且含分隔符和键名 —— 它们都不满足“二进制协议直写”需求。比如你要拼一个 DNS 查询包、自定义 RPC header、或嵌入固件镜像，就必须控制每一个字节。
-
gob不跨语言，json体积大、解析慢、不保序，都不适合底层协议编码 -
binary.Write零分配（配合bytes.Buffer）、无反射开销，性能关键路径首选 - 真正容易被忽略的是：它不校验数据合法性 —— 写
int32(-1)就真写0xFFFFFFFF，不会转成无符号，协议设计者得自己确认语义
