binary.Read/Write 不校验数据完整性，需手动在结构体末尾添加校验字段（如CRC32），写入前计算并写入校验值，读取时先解析业务字段再单独读校验值并比对。
为什么直接用 binary.Read / binary.Write 会丢校验逻辑
Go 标准库的 binary.Read 和 binary.Write 只负责字节序列与 Go 值之间的转换，不关心数据完整性。一旦文件被意外截断、磁盘静默错误或传输损坏，读取时可能成功解出“看似合理”的结构体，但内容已错——而你毫无察觉。
真正需要的是：在写入时追加校验字段（如 CRC32 或 SHA256），读取时重新计算并比对。校验必须覆盖**全部业务数据字段**，不包含校验字段自身，否则会形成循环依赖。
- 校验算法选
crc32.ChecksumIEEE（轻量、快、适合小文件）或sha256.Sum256（强一致性，适合关键配置） - 校验值应作为结构体最后一个字段写入，且读取时先跳过它做数据解析，再单独读取并验证
- 不要把校验值存在结构体 tag 里——
binary不解析 tag，得手动控制字节布局
如何定义可校验的二进制结构体并控制字节顺序
结构体必须是导出字段、固定大小、无指针/切片/字符串（这些无法直接 binary 编码）。字符串需转为定长 [32]byte，切片需拆成长度+元素数组。
示例：一个带 CRC 的配置头
立即学习“go语言免费学习笔记（深入）”；
type ConfigHeader struct {
Version uint16 // 2 bytes
Flags uint8 // 1 byte
Name [16]byte // 16 bytes
Crc uint32 // 4 bytes —— 必须放最后，且不参与校验计算
}
-
Version和Flags字段本身不校验，但它们的值会影响最终Crc计算结果 - 写入前调用
h.CalculateCrc()（手动实现），将h.Version到h.Name的原始字节喂给crc32.ChecksumIEEE - 注意字节序：默认用
binary.LittleEndian；若协议要求大端，所有binary.Write必须统一传binary.BigEndian
读取时如何安全地分离数据与校验值并验证
不能一次性 binary.Read 整个结构体，因为那样会把 Crc 字段也当作原始数据读进来，导致校验时混入旧值。
正确做法是分两步：先读数据部分（不含 Crc），再读 Crc 字段，最后比对。
var h ConfigHeader
// 1. 只读前 sizeof(ConfigHeader)-4 字节（跳过最后 4 字节 Crc）
if err := binary.Read(r, binary.LittleEndian, h.dataFields()); err != nil {
return err
}
// 2. 单独读 Crc
var crc uint32
if err := binary.Read(r, binary.LittleEndian, &crc); err != nil {
return err
}
// 3. 重算并比对
if h.CalculateCrc() != crc {
return fmt.Errorf("crc mismatch: got %x, want %x", crc, h.CalculateCrc())
}
-
h.dataFields()是个返回struct{...}的方法，只包含Version、Flags、Name字段，类型必须和内存布局完全一致 - 如果用
io.ReadFull手动读字节切片，要确保偏移和长度精确——少读 1 字节就可能让后续所有字段错位 - 校验失败时不要继续解析后续数据，立即返回错误；静默忽略等于放弃校验意义
写入时如何避免校验字段污染自身计算
写入流程必须严格按顺序：填业务字段 → 计算校验值 → 写业务字段 → 写校验值。任何一步颠倒都会使校验失效。
- 先设置
h.Version = 1、h.Flags = 0x02、填充h.Name，再调用h.CalculateCrc() -
CalculateCrc()内部必须用unsafe.Slice(unsafe.StringData(h.rawBytes()), len(h.dataBytes()))或binary.Write到bytes.Buffer获取原始字节，**绝不能包含Crc字段的内存区域** - 写入时同样分两步：
binary.Write(w, le, h.dataFields())，再binary.Write(w, le, h.Crc) - 如果使用
encoding/binary的Write方法，务必确认w是支持 seek 的（如*os.File），否则无法回写校验值（不推荐回写，应顺序写）
最易被忽略的一点：结构体字段对齐会影响实际二进制布局。Go 默认按字段最大对齐数填充（如含 uint64 就可能插入 padding），必须用 //go:packed 或确保字段顺序从大到小排列，并用 unsafe.Sizeof 验证总大小是否符合预期。
