Go处理TCP二进制协议需主动定义消息边界，采用“4字节大端长度头+payload”封包，拆包分两步读并校验长度，binary.Read要求结构体字段导出、定长、字节序一致，缓冲区需复用防GC。
Go语言处理二进制协议的封包与拆包，核心在于主动识别消息边界——TCP本身不提供包概念，所有“一包数据”的语义必须由应用层定义并严格执行。跳过这一步直接用 binary.Read 读 net.Conn，几乎必然出错。
封包：固定长度头 + 原始数据
最通用、跨语言兼容的方案是「4 字节大端长度头 + payload」：
- 长度字段用
uint32，避免int跨平台长度不一致 - 头部统一用
binary.BigEndian.PutUint32(buf[:4], uint32(len(data))) - 写入时确保原子性：先
io.WriteFull(conn, header)，再io.WriteFull(conn, data) - 长度字段不加密、不压缩，否则接收端无法预判要读多少字节
- 可设上限（如
MaxBodySize = 1<code>MB），防恶意构造导致 OOM
拆包：分两步读，严格校验
不能依赖一次 conn.Read() 得到完整包，必须按协议分阶段解析：
- 先用
io.ReadFull(conn, headerBuf[:4])读齐 4 字节头 - 用
binary.BigEndian.Uint32(headerBuf[:4])解出包长pkgLen - 立即校验：
if pkgLen == 0 || pkgLen > MaxBodySize→ 关闭连接 - 分配缓冲区
data := make([]byte, pkgLen)，再调用io.ReadFull(conn, data) - 拿到完整字节切片后，再用
bytes.NewReader(data)包装，传给binary.Read
解析：结构体与变长字段的正确姿势
binary.Read 只支持定长原始类型，对结构体有硬性要求：
立即学习“go语言免费学习笔记（深入）”；
- 所有字段名必须首字母大写（导出），小写字段会被静默跳过
- 禁用
int/uint，改用int32、uint16等定长类型 - 字符串或切片字段不能直接放结构体里，会 panic；应改为
Name [32]byte，读完用bytes.TrimRight去零 - 真正变长内容（如用户名）需手动拆解：先读
nameLen uint16，再io.ReadFull(r, nameBuf[:nameLen]) - 字节序必须与协议一致——抓包看原始 hex：若前 4 字节是
00 00 01 00，对应值为 256，则必须用BigEndian
性能与健壮性关键点
高频场景下，瓶颈往往不在解析本身，而在内存和控制流管理：
- 每个连接独享缓冲区，禁止全局共享
bytes.Buffer或切片 - 预分配固定大小缓冲区（如
make([]byte, 0, 4096)），复用nameBuf、payloadBuf，减少 GC - 禁用
unsafe.Pointer强转：看似快，但字段对齐、填充、GOARCH 变更会导致静默崩溃 - 不用
SetReadDeadline“等包”，超时应由协议层（如 request-id + timeout 字段）驱动业务重试 - 粘包处理必须循环：一次
Read可能带回 0.5 包 + 2 完整包 + 0.3 包，需累积后 while 切分
