必须用 extern "C" 导出工厂函数，因 C++ name mangling 会导致 GetProcAddress/dlsym 找不到符号；接口基类须为纯虚类，工厂函数返回指针由主程序 delete，需确保 new/delete ABI 一致；插件须提供 extern "C" 的 destroy_plugin 配套函数清理资源。
直接用 LoadLibrary + GetProcAddress（Windows）或 dlopen + dlsym（Linux）就能搭出可用的插件工厂，但“轻量”不等于“随便写”，关键在符号导出、类型安全和错误兜底——三者漏一，运行时崩溃就是常态。
为什么必须用 extern "C" 导出工厂函数
C++ 编译器会对函数名做 name mangling，比如 create_plugin() 可能变成 ?create_plugin@@YAPAVPluginBase@@XZ。而 GetProcAddress 和 dlsym 只认原始符号名，找不到就返回 NULL。
- 必须显式加
extern "C"：避免 mangling，保证符号名与字符串字面量一致 - Windows 示例：
extern "C" __declspec(dllexport) PluginBase* create_plugin_0(); - Linux 示例：
extern "C" __attribute__((visibility("default"))) PluginBase* create_plugin_0(); - 别依赖
#pragma comment(linker, "/EXPORT:...")—— 它只影响 .lib 生成，不影响运行时符号可见性
如何安全调用 dlsym / GetProcAddress 返回的函数指针
拿到函数指针后不能直接强转调用，C++ 类型系统不会帮你检查 ABI 兼容性。一旦插件和主程序的 PluginBase 布局不一致（比如虚表偏移不同），plugin->run() 就会跳到随机内存地址。
- 接口基类必须是纯抽象类（只有
virtual函数 +virtual ~PluginBase() = default;），且不带数据成员 - 工厂函数返回的是基类指针，但实际对象内存由插件 DLL 分配，主程序负责
delete—— 必须确保 new/delete 跨模块 ABI 一致（推荐统一用静态链接 MSVCRT 或 libc++） - 调用前务必检查指针非空：
if (create_func) { auto p = create_func(); if (p) p->run(); } - 不要把
HMODULE或void*存全局变量长期持有；DLL 卸载后指针立即失效
Linux 下 dlopen 失败的常见原因和排查顺序
dlopen 返回 NULL 不代表文件不存在，更可能是依赖链断裂或符号不可见。
立即学习“C++免费学习笔记（深入）”；
- 先确认路径：传绝对路径最稳，相对路径需确保当前工作目录正确（
getcwd打印一下） - 检查是否编译为位置无关：
g++ -fPIC -shared plugin.cpp -o libplugin.so，漏-fPIC会导致dlopen静默失败 - 确认符号导出：
nm -D libplugin.so | grep create_plugin，没输出说明visibility("default")没生效 - 查依赖缺失：
ldd libplugin.so，看是否有not found行 - 获取错误信息必须用
dlerror()，不是errno；且dlerror()是“消费型”接口，调一次就清空，要立刻保存
插件卸载时最容易被忽略的资源泄漏点
多数人只记得 dlclose 或 FreeLibrary，但忘了插件内部可能持有资源：线程、文件句柄、全局单例、STL 容器析构异常等。
- 强制要求插件提供
destroy_plugin(PluginBase*)配套函数（同样extern "C"导出），由主程序调用后再delete - 禁止插件在 DllMain /
__attribute__((constructor))中做任何跨模块操作（如调用主程序函数、初始化 std::cout） - 若插件用了第三方库（如 OpenSSL），确保其初始化/清理逻辑被显式封装进 init/destroy 函数中
- Windows 上
FreeLibrary成功 ≠ DLL 已卸载，只是引用计数减一；只有计数归零才真正释放，所以别假设“调完就没了”
真正的轻量不靠删代码，而靠约束边界：用 C 接口切掉 C++ ABI 依赖，用纯虚基类守住二进制兼容，用显式 init/destroy 控制生命周期。剩下那些“自动发现插件目录”“热重载”“版本校验”的需求，都是在这些地基打牢之后才值得加的上层功能。
