C++原生不支持运行时反射，因编译期擦除类型与成员名，typeid.name()不可靠，std::any无字段名及注解信息；需用宏+静态注册表手动构建“类名→字段→类型/注解”映射。
为什么 C++ 原生不支持运行时反射，而 std::any + std::type_info 无法直接替代注解映射
C++ 编译期擦除类型名和成员名，typeid 返回的 std::type_info::name() 是实现定义的 mangled 名，不可靠；std::any 只能存值，不携带字段名、注解元数据或访问路径信息。所谓“反射”，在 C++ 里本质是手动构造一张「类名 → 字段名 → 类型/注解 → getter/setter」的静态映射表。
如何用宏 + 静态注册表实现类成员到自定义注解的绑定
核心思路：每个带注解的类，在定义时通过宏触发静态初始化，在全局注册表中插入一条 struct FieldMeta 记录，包含字段偏移、类型 ID、字段名、注解字符串（如 "json_name=uid;required=true"）等。
- 定义注解宏：
REFLECT_FIELD(name, ...)展开为一个匿名命名空间内的static const FieldMeta reg_ ## name{...}，利用静态变量构造顺序保证注册早于 main - 字段偏移不能硬编码，必须用
offsetof(MyClass, field)—— 注意该宏仅对标准布局类型（POD 或满足 std::is_standard_layout_v）安全 - 注解字符串建议用分号分隔键值对，解析时用
std::string_view切分，避免堆分配；常见 key 如json_name、db_column、ignore - 注册表本身用
std::unordered_map<:string_view std::vector fieldmeta>></:string_view>，key 是类名（需用__PRETTY_FUNCTION__提取或手动传入）
reflect::get_field_meta("User", "id") 返回空？检查这三处硬伤
这个调用返回空指针，90% 情况不是逻辑错，而是底层约束被违反：
- 类未用
REFLECT_CLASS(User)宏包裹 —— 宏必须出现在类定义外且紧邻，否则静态注册变量未生成 - 字段名拼写大小写不一致，或含多余空格（C++ 成员名区分大小写，且宏展开时不会 trim）
- 链接时优化（
-O2 -flto）导致静态注册变量被丢弃：需对注册变量加__attribute__((used))或[[gnu::used]]（GCC/Clang），MSVC 用__declspec(selectany)
解析注解字符串时，std::map<:string std::string></:string> 不是好选择
注解键值对数量极少（通常 ≤5），且只在初始化时解析一次。用 std::map 引入红黑树开销和内存分配，得不偿失。
立即学习“C++免费学习笔记（深入）”；
- 改用固定大小数组 + 线性查找：
std::array<:pair std::string_view>, 8></:pair>，编译期可知容量 - 键统一转小写再比较（如
json_name和JSON_NAME视为等价），避免用户配置歧义 - 若注解含嵌套结构（如
validate=range(1,100)），不要当场解析——先存原始字符串，等真正序列化/校验时再按需 parse，降低启动开销
真正难的不是注册或查找，而是让不同模块的宏注册不冲突、不重复初始化、不因模板实例化爆炸。如果类带模板参数（如 User<int></int>），类名字符串必须唯一可识别，否则注册表会覆盖。这时候就得放弃自动推导，显式传入 REFLECT_CLASS_NAME("User_int")。
