必须用-fvisibility=hidden加显式__attribute__((visibility("default")))组合，否则将引发符号冲突、二进制膨胀、ABI不兼容三重问题；因编译器按翻译单元单独处理可见性，仅靠target_compile_options添加选项无法覆盖所有子目录源文件，须在根CMakeLists.txt设全局预设并为每个共享库target显式配置属性，且类、虚函数、模板实例化、静态成员等均需逐项标注，extern "C"中namespace失效，需强制命名规范，虚函数表和RTTI默认导出易致运行时类型转换失败。
必须用 -fvisibility=hidden + 显式 __attribute__((visibility("default"))) 组合，否则大型跨工程必然出现符号冲突、二进制膨胀、ABI 不兼容三重问题。
为什么 -fvisibility=hidden 不能只加在编译选项里
很多人在 target_compile_options() 中加了 -fvisibility=hidden 就以为万事大吉，但 CMake 子目录中通过 add_subdirectory() 引入的源文件可能完全不受影响。C++ 编译器对每个翻译单元单独处理可见性，漏掉一个 .cpp，就可能导出一整套虚表、RTTI 和模板实例化符号。
正确做法是：
- 根
CMakeLists.txt中设全局预设：set(CMAKE_CXX_VISIBILITY_PRESET hidden)和set(CMAKE_VISIBILITY_INLINES_HIDDEN ON) - 对每个共享库 target 显式设置：
set_target_properties(your_lib PROPERTIES CXX_VISIBILITY_PRESET hidden VISIBILITY_INLINES_HIDDEN ON) - 验证是否生效：
readelf -s libyour.so | grep "FUNC.*GLOBAL.*DEFAULT"输出应极少，且仅限你手动标记的接口
__attribute__((visibility("default"))) 标在哪才真正有效
给类加这个属性，不等于它的所有成员都自动导出——构造函数、析构函数、虚函数、静态成员函数仍需显式标注，否则链接时会报 undefined reference。更隐蔽的是：模板类的显式实例化（如 template class MyClass<int>;</int>）必须和类定义在同一 visibility 控制下，否则实例化符号可能被隐藏，而调用方又找不到。
立即学习“C++免费学习笔记（深入）”；
安全写法：
- 类声明前加属性：
class __attribute__((visibility("default"))) NetworkClient { ... }; - 静态成员变量必须单独标注：
__attribute__((visibility("default"))) extern int NetworkClient::counter; - 内联函数若在头文件中定义，必须确保所在头文件被包含前已定义
__attribute__宏，否则可能因多次包含生成多个 LOCAL 符号，触发 ODR 违规
extern "C" 接口为什么 namespace 完全无效
一旦进入 extern "C" 块，C++ 的 name mangling 被关闭，namespace ModuleA::init() 和 namespace ModuleB::init() 全部退化为裸符号 init。两个插件同时导出 init，Linux 动态链接器按加载顺序覆盖，行为不可控。
唯一可靠方案：
- 禁止在
extern "C"块内使用namespace - 强制命名规范：头文件中直接声明
int acme_v2_config_load();，实现与声明前缀严格一致 - 不用宏替换（如
#define init acme_v2_init），它只是文本替换，无法阻止原始符号init被意外导出
运行时加载隔离：当编译期控制已失效时怎么办
第三方闭源库无法修改源码，或已有历史 so 文件无法重编，此时只能靠加载策略兜底。Linux 下 dlopen() 的 RTLD_LOCAL | RTLD_DEEPBIND 是关键组合：
-
RTLD_LOCAL：防止该库的符号泄漏到全局符号表 -
RTLD_DEEPBIND：让库内部对同名函数的调用优先绑定到自身定义，而非全局已存在的版本 - 两个冲突库必须分别
dlopen，且不能混用RTLD_GLOBAL；调用时必须通过dlsym(handle, "func")显式获取，不能依赖隐式链接
注意：RTLD_DEEPBIND 在某些旧版 glibc 中有兼容性问题，且 macOS 不支持——这意味着跨平台项目中，它只是临时补救，不是长期解法。
最易被忽略的点：虚函数表和 RTTI 符号默认导出，哪怕类本身没标 visibility("default")，只要类有虚函数且未隐藏，typeinfo 和 vtable 就会进入动态符号表。这类符号撞车不会报链接错误，而是在运行时类型转换失败或 dynamic_cast 返回空指针，排查成本极高。
