binary.Read 无法读取含 slice、string、map 等动态类型字段的结构体，仅支持固定大小的导出字段（如 uint32、[32]byte），且需注意字节序、长度校验、显式填充及协议隐含规则。
为什么 binary.Read 读不到完整结构体？
常见现象是读完前几个字段就 io.ErrUnexpectedEOF，尤其当结构体含 []byte 或指针字段时。根本原因是 binary.Read 只处理固定大小的底层类型（如 int32、uint16），不支持 slice、string、map 等动态长度类型——它会直接 panic 或跳过字段。
实际协议里“固定长度”往往指：每个字段有明确字节数（比如 4 字节命令码 + 2 字节长度 + 32 字节 ID），但 Go 结构体若写成 type Header struct { Cmd uint32; Len uint16; ID [32]byte } 才能被 binary.Read 安全处理；一旦用 string 或 []byte 就失效。
- 必须用数组（
[N]byte）替代切片表示定长字段 - 结构体字段需导出（首字母大写），且不能含未导出字段或嵌套非二进制兼容结构体
- 注意字节序：协议约定是大端（network byte order）就用
binary.BigEndian，小端用binary.LittleEndian
如何处理协议中“长度前缀 + 变长内容”？
纯 binary.Read 无法自动读取变长部分，得拆成两步：先读定长头，再根据头里的长度字段手动读取后续字节。
例如协议定义为 [2]byte len + [len]byte payload：
// 先读长度字段
var plen uint16
if err := binary.Read(r, binary.BigEndian, &plen); err != nil {
return err
}
// 再读指定长度的 payload
payload := make([]byte, plen)
if _, err := io.ReadFull(r, payload); err != nil {
return err
}
-
io.ReadFull比io.Read更可靠，确保读满plen字节 - 如果 payload 本身还有子结构（比如含另一个定长头），别嵌套用
binary.Read，应把payload包装成bytes.NewReader(payload)再读 - 注意长度字段溢出风险：协议中 2 字节长度最大 65535，但实际分配内存前应校验是否过大（防 OOM）
binary.Write 写入失败的典型原因
最常遇到的是 binary.Write: invalid type 错误，本质和读一样：传入了不支持的类型。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
可安全写入的类型仅限：bool、整数类（int8~uint64）、浮点类（float32、float64）、数组（[N]T），以及由这些类型组合的结构体（字段必须导出、无指针/切片/string）。
- 别传
*MyStruct，要传MyStruct{}值类型 - 字符串要转
[]byte后按数组写，例如[32]byte：用copy(buf[:], str)填充，末尾补零 - 写入前确认
io.Writer支持写（比如bytes.Buffer可写，os.Stdin不行）
字节对齐与填充字段怎么处理？
协议文档里可能写“保留 4 字节对齐”，但 Go 结构体默认按字段自然对齐（int64 对齐到 8 字节），导致二进制布局错位。这时不能依赖 struct tag（binary 包完全忽略 struct{...}`align:"1"` 这类 tag），而要用显式占位字段。
例如协议要求字段后填 3 字节 padding：
type Packet struct {
Cmd uint8
_ [3]byte // 显式填充，不是用 `padding [3]byte` 这种命名（虽可读性差，但必要）
Data uint32
}
- 填充字段名用
_最安全，避免意外参与逻辑 - 不要用
unsafe.Alignof或reflect计算偏移——协议是静态定义的，硬编码字段顺序和长度更稳 - 如果协议含多段嵌套结构（如 header + body + footer），建议每个部分单独定义结构体并分别读写，别塞进一个大 struct
真正麻烦的永远不是读写本身，而是协议文档里没写明的隐含规则：比如某字段实际是 ASCII 字符串但要求右对齐、空格填充，或者时间戳用毫秒但文档只写“4 字节整数”。这种细节不验证，上线后连字节流都对不上。
