默认导出所有符号存在符号污染、ABI泄露和启动变慢三大隐患；应采用-fvisibility=hidden配合__attribute__((visibility("default")))显式导出，或用--version-script精确控制，C++类须通过extern "C"导出纯虚接口工厂函数。
为什么默认导出所有符号是个隐患
Linux 下用 gcc -shared 编译的 .so，默认会把所有非 static 的全局符号都放进动态符号表（DT_SYMTAB），包括类成员函数、内部工具函数、甚至第三方静态库里的符号。这会导致：
- 符号污染：两个模块里同名的
CTest类被动态链接器误解析到先加载的那个，调用AMemFunc()直接崩溃 - ABI 泄露：用户能
dlsym拿到你不打算公开的函数地址，后续改名或删掉就破坏兼容性 - 启动变慢：动态链接器要遍历更多符号做重定位，尤其在嵌入式或容器冷启场景下明显
用 -fvisibility=hidden + 属性标记最常用
这是跨平台项目最主流的做法，原理是“默认全藏，显式放行”。关键点不是加了什么，而是顺序和范围：
-
gcc编译每个源文件时必须带-fvisibility=hidden，否则属性无效 -
__attribute__((visibility("default")))必须加在声明上，不是定义上；C++ 类要整个类加，不能只给某个成员函数加 - 头文件里写宏更安全：
#define DLL_PUBLIC __attribute__((visibility("default")))，然后DLL_PUBLIC void api_func(); - 如果用了
extern "C"，属性得套在外面：extern "C" { DLL_PUBLIC int calc(int); }，顺序错就失效
用 --version-script 精确控制导出列表
当你没法改源码（比如封装第三方库），或者想彻底隔离内部符号时，version script 是唯一可靠方案。它不依赖编译器属性，由链接器 ld 直接执行：
- 写一个
export.map文件：{ global: init_library; cleanup; local: *; }; - 链接时加参数：
gcc -shared -Wl,--version-script=export.map -o libfoo.so foo.o bar.o - 检查结果：
readelf -d libfoo.so | grep SONAME和nm -D libfoo.so，只该出现init_library和cleanup - 注意：
--version-script只对 ELF 有效（Linux/macOS），Windows 的.dll不支持；且脚本里不能有 C++ mangled 名，必须用extern "C"导出的符号名
C++ 类导出必须绕过成员函数直接暴露
别试图导出 class Foo 或它的 public 成员——名字修饰（mangling）让符号在不同编译器/标准库间不一致，std::string 成员更是灾难。正确路径只有一条：
- 定义纯虚接口：
struct IFoo { virtual int do_work() = 0; virtual ~IFoo() = default; }; - 工厂函数用
extern "C"导出：extern "C" DLL_PUBLIC IFoo* create_foo(); - 实现类放在源文件里，不暴露头文件；所有构造、析构、内存管理都在工厂函数内完成
- 用户拿到的是指针，调用走 vtable，完全避开符号名和 ABI 绑定问题
真正麻烦的从来不是怎么导出，而是导出之后别人能调什么、不能调什么——符号可见性一旦设错，修复成本远高于初始设计。
