Protobuf不能直接序列化C++结构体，必须先定义.proto文件并用protoc生成C++类；字段编号不可更改，类型变更需谨慎；Proto3默认optional，repeated对应vector；需校验enum值并避免频繁堆分配。
Protobuf 不是直接序列化 C++ 结构体，必须先定义 .proto 文件
Protobuf 本身不支持“反射式”自动序列化任意 struct，你不能把一个已有的 C++ struct 直接丢给 SerializeToString()。必须先用 Protocol Buffers 的接口定义语言（IDL）写一个 .proto 文件，描述字段名、类型、编号，再用 protoc 编译器生成对应的 C++ 类。
常见错误：试图绕过 .proto，用宏或模板“自动绑定”原生结构体——这会丢失字段编号语义、破坏向后兼容性，且无法跨语言互通。
正确做法：
- 新建
person.proto，定义message Person，字段编号从 1 开始连续、不跳空 - 运行
protoc --cpp_out=. person.proto，生成person.pb.h和person.pb.cc - 在 C++ 中
#include "person.pb.h"，用生成的Person类（而非你原来的struct）来存数据
字段编号和 optional/required/repeated 必须按语义选对
字段编号不是序号，而是二进制格式里的唯一标识符；一旦发布，就不能改。比如 int32 id = 1; 后来想改成 uint32 id = 1; 是安全的（同 wire type），但改成 string id = 1; 就会解包失败，报 Protocol buffer parse error: invalid wire type。
立即学习“C++免费学习笔记（深入）”；
Proto3 默认所有字段都是 optional（即使不写关键字），但如果你需要区分“未设置”和“默认值”，得显式用 optional（Proto3.12+）或改用 oneof。而 repeated 对应 std::vector，不是裸数组。
示例片段：
message Person {
int32 id = 1;
string name = 2;
repeated string email = 3; // 生成 std::vector<std::string>
}注意：name 字段即使为空字符串，序列化后也会保留；若想省略空值，需用 optional string name = 2; 并手动调用 has_name() 判断。
序列化前务必检查 required 字段（Proto2）或验证逻辑（Proto3）
Proto2 中 required 字段未设值时，SerializeToString() 返回 false，但不会抛异常；Proto3 已移除 required，所以容易误以为“只要编译通过就一定能序列化”。实际中，像 enum 赋了非法整数值、bytes 指针为空却调用了 set_allocated_*，都会导致后续 SerializeToString() 崩溃或静默截断。
建议操作：
- 对
enum字段，用生成类的IsInitialized()（Proto2）或手动校验范围（Proto3） - 避免直接用
set_allocated_*，优先用set_*或mutable_* - 调试时开启
GOOGLE_PROTOBUF_VERIFY_VERSION宏，防止链接不同版本 protobuf 库
性能关键点：避免反复 new/delete，复用对象和缓冲区
Protobuf 生成的 C++ 类默认使用 arena 分配器（如果启用），但普通构建下每次 new Person 都触发堆分配。高频场景下，这比序列化本身更耗时。
优化方式：
- 用栈对象：
Person p;而非auto* p = new Person; - 复用对象：调用
p.Clear()重置状态，比重建更快 - 预估大小：用
p.ByteSizeLong()获取长度，再reserve()输出std::string，避免多次 realloc - 零拷贝输出：如需写入 socket 或文件，用
SerializeToZeroCopyStream()配合google::protobuf::io::OstreamOutputStream
注意：ByteSizeLong() 在字段多、嵌套深时有开销，别在 tight loop 里反复调。
