私有协议实现真正兼容的核心是字段ID+可变长编码+显式跳过逻辑。必须为每个字段分配唯一不可复用的16位ID，序列化时先写ID再写长度和值，反序列化时依ID查表或跳过未知字段，禁止依赖顺序解析、强类型绑定或结构体大小校验。
私有协议要真正支持向前兼容和向后兼容，核心不是加字段或改结构，而是放弃“按顺序解析”和“强类型绑定”的惯性思维。必须用字段 ID + 可变长度编码 + 显式跳过逻辑，否则任何新增字段、重排字段、删字段都会导致解析崩溃或静默错位。
字段必须带唯一 ID，不能靠位置或顺序
旧协议常把 struct 直接 memcpy，靠字段偏移读取——这完全无法兼容。新设计中每个字段必须分配一个 16 位整数 ID（如 0x0001 表示 user_id，0x0002 表示 timestamp），且 ID 一经发布不可复用、不可重映射。
- 序列化时：先写 ID（2 字节），再写长度（可变长整型，如 varint），最后写值
- 反序列化时：读 ID → 查表判断是否认识 → 认识则按对应类型读长度+值；不认识则按长度字段跳过整段
- 禁止用 ID 0 作为有效字段，它应保留为分隔符或保留位
必须显式处理未知字段，不能依赖“结构体大小”
常见错误是反序列化函数看到 buffer 长度变长就 panic，或直接忽略尾部字节。正确做法是：每读一个字段，都用其声明的 length 字段推进读取位置，而不是用 sizeof(MyStruct) 做硬校验。
- 例如字段
0x0005类型为 string，编码为[05 00][03][61 62 63]，其中03是长度，必须据此跳过 3 字节 - 若遇到
0x000A（未定义字段），仍要读出它的 length 字段（哪怕只是 1 字节 varint），然后跳过对应字节数 - 不跳过会导致后续所有字段 ID 错位，整个包解析雪崩
可选字段与默认值必须由协议层控制，而非 C++ 类型系统
C++ 的 std::optional<int></int> 或 std::unique_ptr<t></t> 在序列化时无法表达“该字段不存在”。协议必须自带存在性标记，且默认值不能依赖构造函数或成员初始化器。
- 可选字段在编码时：存在则写完整 ID+length+value；不存在则完全不写
- 反序列化时：若字段 ID 未出现，直接使用 .proto 中声明的 default 值（如
default = 42），而不是调用T{} - 禁止用
memset(0)初始化结构体来“模拟默认值”，因为 padding 字节不可控，且不同编译器填充策略不同
数组和嵌套消息需独立编码边界，不能共享 length 字段
把 repeated 字段当成普通数组塞进 struct，或让外层 length 涵盖内层数据，都会破坏字段级跳过能力。每个 repeated 字段必须有自己的 ID 和独立 length 前缀。
- 例如
repeated Item items = 3;编码为：[03 00] [varint N] [item1...] [item2...] ... [itemN...] - 嵌套消息同理：子消息整体视为一个 value，先读子消息总长度，再在其内部递归执行字段 ID 解析
- 避免 “length-of-length” 嵌套过深，建议单层 varint 最大不超过 5 字节（覆盖 2^35）
最容易被忽略的一点：兼容性不取决于你加了多少新字段，而取决于你是否让旧代码在遇到新字段时能安全地“路过”。只要有一个字段没跳过，或者跳过的字节数算错，整个协议的向前/向后兼容就形同虚设——而且这种 bug 往往只在灰度阶段爆发，上线后才暴露。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
