C++标准不支持运行时反射，所谓“成员函数自动绑定”本质是手动构造映射表+宏或模板辅助生成；成员函数指针因隐含this参数，类型与普通函数指针不兼容，直接存入std::unordered_map会编译失败，须通过std::function<void(void*)>统一包装并显式传入对象指针，配合宏注册（如REFLECT_METHOD）在启动时填表，兼顾轻量、无RTTI依赖与线程安全调用。
C++ 标准不支持运行时反射，所谓“成员函数自动绑定”本质是手动构造映射表 + 宏或模板辅助生成，没有银弹，只有取舍。
为什么不能直接用 std::function 绑定成员函数指针到字符串名
成员函数指针不是普通函数指针，它隐含 this 参数，类型系统严格区分 void (A::*)() 和 void (*)()；直接存进 std::unordered_map<:string std::function>> </:string> 会编译失败，除非你显式绑定对象实例（失去通用性）或用类型擦除包装器。
- 常见错误现象：
error: no matching function for call to 'std::function<void>::function(<unresolved overloaded function type>)'</unresolved></void> - 正确做法：统一转成
std::function<void></void>或std::function<void></void>，把对象指针作为参数传入 - 映射表值类型建议定义为
std::function<void></void>，兼顾多类复用（调用时强制static_cast） - 若只服务单个类，用
std::function<void></void>更安全，避免误传非法指针
宏 + 静态注册表：最轻量的运行时映射方案
不用第三方库、不依赖 RTTI 或 C++20 反射 TS，靠预处理宏在编译期生成注册代码，启动时填表。核心是让每个函数注册语句变成一行可展开的宏调用。
- 定义注册宏：
#define REFLECT_METHOD(cls, name) registry[#name] = [](void* obj) { static_cast<cls>(obj)->name(); };</cls> - 在类外全局作用域（如 .cpp 文件底部）集中注册：
REFLECT_METHOD(MyClass, doWork); REFLECT_METHOD(MyClass, reset); - 注意：宏里不能有重载函数名，否则
#name展开后无法消歧义；需配合无参或签名唯一的方法 - 性能影响极小——只是指针赋值，无虚函数开销，无动态内存分配
如何安全调用映射表中的成员函数
调用时必须确保传入的 void* 真是指向对应类型的合法对象，否则行为未定义。别指望编译器帮你检查。
立即学习“C++免费学习笔记（深入）”；
- 典型调用模式：
if (auto it = registry.find("doWork"); it != registry.end()) { it->second(obj_ptr); } - 容易踩的坑：忘记判空直接调用
it->second，或传入已析构/未初始化的指针 - 增强健壮性可加断言：
assert(obj_ptr != nullptr && "null object passed to reflected method"); - 若需返回值，映射表值类型得改成
std::function<:any></:any>或模板化容器——但会显著增加复杂度，多数场景用void回调更实际
为什么不用 std::map 而用 std::unordered_map
字符串查找是反射调用的热点路径，std::unordered_map 平均 O(1)，std::map 是 O(log n)，当方法数超过二三十个时差异可测。
- 兼容性注意：C++11 起
std::unordered_map支持std::string作 key，无需自定义哈希 - 若需保证遍历顺序（比如调试打印所有方法），才退回到
std::map，但反射调用本身不依赖顺序 - 极端内存敏感场景（嵌入式），可考虑静态数组 + 线性查找，方法数少于 10 时比哈希表更快
真正麻烦的从来不是怎么建表，而是怎么管理对象生命周期和类型安全——映射表本身几行代码就能写完，但谁来保证 void* 不野指针、不跨继承体系误用、不在多线程中被并发释放，这些才是实际项目里卡住进度的地方。
