C++原生不支持反射因标准未提供编译期类型结构信息，仅靠RTTI有限支持；模板+宏通过编译期生成字段元数据表模拟反射，需手动注册且依赖标准布局和显式声明。
为什么C++原生不支持反射，但模板+宏能“模拟”出基本能力
C++标准至今没有运行时类型信息（RTTI）以外的反射支持，typeid和dynamic_cast只能做有限类型查询，没法枚举成员、调用任意字段或方法。所谓“简单反射”，本质是**在编译期把类型结构信息固化下来**，靠模板推导类型、宏展开生成注册代码，再配合静态表实现查找。它不依赖运行时解析，所以快、无额外依赖，但代价是：所有要反射的类型必须显式声明，且字段/方法名得硬编码进宏里。
用REFLECTABLE宏定义可反射结构体，并生成字段元数据
核心思路是让每个结构体带一个静态成员函数，返回其字段描述数组。宏负责生成这个函数和字段名、偏移、类型的元数据。
常见错误是字段顺序与offsetof计算不一致（比如有虚函数或非POD基类），导致偏移错乱；另一个坑是宏里用了__LINE__或未加括号，引发多重展开冲突。
- 确保目标结构体是标准布局（standard-layout）：无虚函数、单继承、相同访问控制符
- 字段名必须字面量字符串，不能是变量——宏无法捕获变量名语义
- 每个字段元数据包含：
name（const char*）、offset（size_t）、type_id（如typeid(int).name()） - 示例宏骨架：
#define REFLECTABLE(...) \ static const reflect::FieldInfo fields[] = { __VA_ARGS__ }; \ static size_t field_count() { return sizeof(fields) / sizeof(fields[0]); } \ static const reflect::FieldInfo* get_fields() { return fields; }
用模板函数get_field_value安全读取任意字段值
给定对象指针和字段名，需在编译期确认字段存在、运行时按偏移提取值。关键不是“泛型”，而是**类型擦除 + 显式转换**：返回std::any或自定义Variant，避免模板实例爆炸。
立即学习“C++免费学习笔记（深入）”；
容易踩的坑包括：对const对象取非const引用、未处理位域或静态成员、忽略对齐要求导致memcpy越界。
- 字段查找必须区分大小写，且应为O(1)哈希查找（预生成
std::unordered_map<std::string, const FieldInfo*>） - 读取时用
reinterpret_cast<const std::byte*>(obj) + offset定位，再memcpy到目标类型缓冲区（比直接reinterpret_cast<T*>更安全） - 不支持引用类型字段直接返回——得返回
std::reference_wrapper或禁止反射引用字段 - 示例调用：
MyStruct s{42, "hello"}; \ auto val = reflect::get_field_value<int>(&s, "id"); // 返回 optional<int>
注册机制必须手动触发，且不能跨编译单元自动合并
宏展开只在当前翻译单元生效，REFLECTABLE生成的静态表不会被链接器自动收集。这意味着：如果你在a.cpp里反射Foo，在b.cpp里想查Foo字段，会找不到——除非你显式在某个cpp里调用reflect::register_type<Foo>()，且该cpp被链接进最终二进制。
这也是最常被忽略的一环：开发者以为“只要加了宏就全局可见”，结果运行时查表为空。
- 注册函数通常是个空模板特化，靠ODR（One Definition Rule）保证只注册一次
- 推荐做法：每个反射类型在头文件里声明，在对应实现文件里调用注册，或强制用户在
main()前调用init_reflection() - 不要依赖
__attribute__((constructor))或init_priority——不同平台行为不一致，且可能早于全局对象构造
真正麻烦的从来不是怎么写宏，而是怎么让所有模块的反射信息在运行时“碰上头”。一旦涉及插件、动态库或分离编译，这套手工注册就得换成构建系统介入（如CMake生成注册列表），否则就是静默失败。
