C++ Protobuf 反射必须通过 Descriptor 和 Reflection 实现：Descriptor 提供只读元信息，Reflection 提供字段读写接口；所有操作依赖 message 实例，且需手动处理类型、重复性、嵌套和生命周期。
protobuf 的 Descriptor 和 Reflection 是唯一入口
没有反射，C++ 的 protobuf 就是纯静态结构——字段名、类型、嵌套关系全在编译期固化，运行时拿不到。想动态读写，必须走 Descriptor + Reflection 这条路，别琢磨 dynamic_cast 或手动解析二进制。核心对象就两个：message.GetDescriptor() 拿描述符，message.GetReflection() 拿反射接口。
注意：所有操作都依赖具体 message 实例（不是 Descriptor 本身），且 Reflection 对象不能脱离原 message 生命周期使用——它不持有数据，只提供访问视图。
-
Descriptor是只读元信息：字段数量、名字、类型（FIELD_TYPE_INT32等）、是否 repeated、是否有 default_value -
Reflection是读写控制器：用GetField()/SetField()操作单值，GetRepeatedField()/AddField()操作 repeated 字段 - 嵌套 message 需要先用
GetMessage()取出子 message 引用，再对其调用GetReflection()
读取任意字段值：类型分支躲不掉
protobuf C++ 反射不提供泛型 get 方法（比如没有 GetValueAsAny()），你得根据 FieldDescriptor::type() 手动分发。这不是设计缺陷，而是为了明确类型安全和避免隐式转换歧义。
常见错误是直接用 GetInt32() 去读 string 字段，结果返回 0 且无提示；或者对 repeated 字段误用单值 getter，触发断言失败。
立即学习“C++免费学习笔记（深入）”；
- 基础类型（int32/bool/float/double/string）用对应
Get<Type>()，如reflection->GetInt32(msg, field) - enum 字段用
GetEnum()，返回const EnumValueDescriptor*，再调number()或name() - bytes 和 string 表示不同语义，但底层都用
GetString()；区别在 .proto 里声明的是bytes还是string - repeated 字段必须用
GetRepeated<Type>()或遍历FieldSize()+GetRepeated<Type>(index)
写入字段前必须检查 required/repeated/optional 状态
反射写入不是“设了就完事”。C++ protobuf 在 debug 模式下会对 required 字段缺失做断言，但反射层不会自动帮你补默认值或初始化 repeated 容器——这些都得自己判空、分配、清空。
典型翻车点：对一个刚 new 出来的 message，直接 SetInt32() 一个 optional 字段，没问题；但对 repeated 字段不先 Add<Type>() 就去 SetRepeated<Type>(0, ...)，会 crash。
- optional 字段可直接
Set<Type>()，写入即生效 - repeated 字段必须先
Add<Type>()（返回引用）或用MutableRepeated<Type>()获取容器指针再 push_back - required 字段没强制校验时机，但序列化前若未设，
SerializeToString()会返回 false - 嵌套 message 字段用
MutableMessage()获取可写引用，不要用GetMessage()（只读）
性能和兼容性：别在热路径用反射
反射调用比直接成员访问慢 10–50 倍（取决于字段深度和类型），因为每次都要查 hash 表、做类型转换、边界检查。它适合配置加载、调试打印、通用序列化桥接等低频场景，不适合高频消息处理循环。
另一个坑是版本兼容：如果 proto 文件升级（比如改字段名、增删字段），旧代码用反射按 name 查字段会失败（FindFieldByName() 返回 null）。线上服务若依赖字段名字符串硬编码，升级就得同步发版。
- 字段查找尽量缓存
FieldDescriptor*指针，别每次用FindFieldByName() - 避免在 for 循环内反复调
GetDescriptor()和GetReflection()，它们开销固定但非零 - 跨语言互通时，Java/Python 的反射行为和 C++ 不完全一致（比如 null vs unset），别假设语义相同
真正麻烦的从来不是怎么调用那几个函数，而是字段类型、重复性、嵌套层级、生命周期这四层嵌套判断——漏一层，运行时就崩给你看。
