跨平台导出函数需统一用extern "C"禁用name mangling，并用宏封装__declspec(dllexport)和__attribute__((visibility("default")))；类导出应仅通过C风格工厂函数返回纯虚接口指针。
在 Windows 上用 __declspec(dllexport) 导出的函数，在 Linux 下链接时直接报 undefined reference，因为 GCC 不识别该修饰符，且 C++ 编译器对函数名做了不同的 name mangling；同时，不同平台的动态库加载机制、符号可见性默认策略、重定位表格式（如 ELF 的 GOT/PLT vs PE 的 IAT）差异，会导致运行时加载失败或调用跳转错乱。
统一启用 C 风格符号导出
第一步：在头文件中为所有需跨平台导出的函数添加 extern "C" 封装。这能禁用 C++ name mangling，使符号名在 Windows（MSVC）、Linux（GCC/Clang）、macOS（Clang）下完全一致。
第二步：用宏抽象平台差异。在头文件顶部定义：
#ifdef _WIN32<br> #define DLL_EXPORT __declspec(dllexport)<br>#else<br> #define DLL_EXPORT __attribute__((visibility("default")))<br>#endif
立即学习“C++免费学习笔记（深入）”；
第三步：导出函数声明写成：extern "C" { DLL_EXPORT int calculate_sum(int a, int b); }。注意 【必须把 extern "C" 和 DLL_EXPORT 同时作用于函数声明，顺序不能颠倒；若只加 DLL_EXPORT 而不加 extern "C"，Linux 下符号名仍是 _Z12calculate_sumii，Windows 下是 ?calculate_sum@@YAHHH@Z，二者完全不匹配】。
控制符号可见性范围
方法一：编译时全局关闭隐藏符号（仅调试用）
GCC/Clang 添加编译选项 -fvisibility=default。但此方式会导出所有非 static 全局符号，增大动态库体积并暴露内部实现，不推荐用于发布版本。
方法二：精准控制（推荐）
源码编译时加 -fvisibility=hidden，再对需导出的函数/类显式标注 __attribute__((visibility("default")))。这样未标注的符号默认不可见，避免意外导出内部辅助函数导致的符号污染。
方法三：Windows 下等效做法
MSVC 不支持 -fvisibility，但可通过模块定义文件（.def）精确列出导出符号。创建 mylib.def，内容为：
EXPORTS<br> calculate_sum<br> init_module，然后链接时传入
/DEF:mylib.def。注意 【.def 文件中的符号名必须是 unmangled 名——即 C 风格名；若函数是 C++ 成员函数且未用 extern "C" 包裹，此处无法正确填写】。
处理类导出的特殊约束
直接导出 C++ 类会导致 vtable、RTTI 符号跨平台不兼容，且虚函数调用在不同 ABI 下可能偏移错误。唯一安全做法是：只导出工厂函数和纯虚接口。
先定义抽象接口：
struct ICalculator {<br> virtual int add(int a, int b) = 0;<br> virtual ~ICalculator() = default;<br>};
再导出 C 风格工厂函数：
extern "C" { DLL_EXPORT ICalculator* create_calculator(); }
调用方通过指针调用虚函数，不依赖具体类布局。这绕开了 ABI 差异问题，也规避了 Windows 下 class 导出需额外处理 DLL_INTERFACE 的繁琐步骤。
验证符号是否正确导出
Windows（MSVC 工具链）：
用 dumpbin /exports mylib.dll 查看输出列表，确认 calculate_sum 出现在导出序号列中，而非类似 ?calculate_sum@@YAHHH@Z 的 mangled 名。
Linux：
用 objdump -T libmylib.so | grep calculate_sum 或 nm -D libmylib.so | grep calculate_sum。若看到 0000000000001234 T calculate_sum（T 表示全局文本段），说明导出成功；若无输出或显示为 U（undefined），说明未导出或 visibility 设置错误。
macOS：
用 nm -DY libmylib.dylib | grep calculate_sum。注意 macOS 动态库默认不导出任何符号，必须显式用 __attribute__((visibility("default"))) 或 -fvisibility=default 才可见。
