Linux下.so默认隐藏所有符号，需用__attribute__((visibility("default")))显式导出类、函数等；Windows需用__declspec(dllexport)，跨平台应以宏隔离；声明处（非实现处）加属性，基类与虚函数必须导出以支持dynamic_cast和RTTI。
Linux 下 .so 默认隐藏所有符号，不加显式声明就找不到
GNU 工具链（gcc/g++）编译动态库时，默认启用 -fvisibility=hidden（即使你没写）。这意味着：所有函数、类、全局变量默认**不导出**，外部可执行文件或其它库 dlsym 找不到，链接时报 undefined reference 或运行时报 symbol not found。
必须对需要暴露的符号手动加 __attribute__((visibility("default")))，否则它们只在本 .so 内部可见。
- 类定义需加在类声明前：
class __attribute__((visibility("default"))) MyClass { ... }; - 自由函数同理：
extern "C" __attribute__((visibility("default"))) int my_func(); - C++ 成员函数自动继承类的 visibility 属性，但虚表（vtable）、RTTI 信息也受此控制——类设为
default才能被dynamic_cast跨库使用 - 头文件中建议用宏封装，避免重复写长属性：
#define EXPORT __attribute__((visibility("default")))
Windows 的 .dll 不靠 visibility，而依赖 __declspec(dllexport)
__attribute__((visibility(...))) 在 Windows（MSVC/MinGW）上**基本无效**。MinGW 可能部分支持，但行为不一致；MSVC 完全忽略它。Windows 动态库必须用 __declspec(dllexport) 显式导出，或通过 .def 文件列出符号。
跨平台项目常用条件宏隔离：
#ifdef _WIN32
#define EXPORT __declspec(dllexport)
#else
#define EXPORT __attribute__((visibility("default")))
#endif
注意：MSVC 下若未加 __declspec(dllexport)，即使链接时不报错，运行时调用也会失败（GetProcAddress 返回 NULL）。
头文件里声明和实现位置影响 visibility 生效范围
visibility 属性必须作用于**定义处**（即符号首次被声明/定义的地方），不是调用处。常见错误是只在实现文件（.cpp）里加属性，但头文件中类/函数声明没加——此时编译器仍按默认 hidden 处理头文件里的声明，导致 ODR 违反或链接失败。
- 正确做法：在头文件中声明时就加上
EXPORT宏（如class EXPORT MyClass;） - 若头文件被多个模块包含，且只想让某模块导出，需用预处理控制：
#ifdef BUILDING_MYLIB+EXPORT，否则其他模块包含该头文件会意外导出符号 - 模板函数/类不能直接加
EXPORT（实例化发生在使用点），需显式实例化并导出：template EXPORT std::vector
make_vec();
忘记导出虚函数或纯虚基类会导致 dynamic_cast 跨库失效
C++ RTTI（类型信息）和虚函数表（vtable）的可见性由类本身的 visibility 控制。如果基类没加 EXPORT，即使派生类加了，dynamic_cast 从派生类指针转回基类时仍可能返回 nullptr（尤其在不同 .so 间传递对象时）。
典型症状：调试时发现 typeid(obj).name() 输出乱码，或 dynamic_cast 总失败，但静态类型检查无误。
- 基类必须
EXPORT，且所有虚函数（包括析构函
数）都隐含受控 - 若基类在另一库中已导出，当前库只需确保继承时不用重新定义 vtable（即不覆写虚函数时可省略导出，但安全起见仍建议显式标注）
- Clang/GCC 提供
-Wmissing-field-initializers类似警告不覆盖 visibility，需靠-Wattributes检查 visibility 是否遗漏
数）都隐含受控