-fvisibility=hidden能缓解符号冲突，因为它使符号默认不导出，仅显式标记为visibility("default")的才可见，从而减少多库同名符号覆盖风险；需配合源码添加导出标记、正确处理模板与inline函数，并用nm/readelf验证导出表。
为什么 -fvisibility=hidden 能缓解符号冲突？
默认情况下，GCC/Clang 编译的动态库（.so）会导出所有非静态全局符号（函数、变量），只要没被 static 或 inline 修饰，就可能被其他模块直接链接——哪怕你根本没打算暴露它。多个动态库若各自定义了同名的非静态全局符号（比如都实现了 log_init()），加载时就可能因符号覆盖或重绑定出错，典型表现是程序行为异常、崩溃，或 dlsym 返回错误地址。
-fvisibility=hidden 的作用是「反转默认行为」：它让所有符号默认不导出，只显式标记为 __attribute__((visibility("default"))) 的才对外可见。这从源头上大幅压缩了潜在冲突面。
- 必须配合源码修改：仅加编译选项不够，否则整个库变“黑盒”，主程序连
init()都调不到 - 头文件中对导出函数/类需统一加宏包装，例如：
#define API_EXPORT __attribute__((visibility("default")))，然后声明extern "C" API_EXPORT void init(); - C++ 类要导出，必须对整个类加
__attribute__((visibility("default")))，成员函数不会自动继承——漏掉类声明而只标了某个方法，该类仍不可见
怎么快速定位是哪个库在导出不该导出的符号？
用 nm -D（或 objdump -T）查动态符号表，比看源码更直接。冲突往往发生在两个库都导出了同名弱符号（W）或全局符号（T/D）。
- 查指定库的所有导出符号：
nm -D liba.so | c++filt | grep 'log_init'
- 对比多个库的输出，找重复出现的非预期符号（比如内部工具函数
str_hash_internal出现在两个库中） - 注意
nm输出中符号类型：T=代码段全局，D=数据段全局，U=未定义（不关心），W=弱符号（最危险，链接器可能随意选一个） - 若发现某库导出了大量本该隐藏的符号，说明它没加
-fvisibility=hidden，或忘了加visibility("default")标记导出点
C++ 模板和内联函数会绕过 -fvisibility=hidden 吗？
会，而且这是最容易踩的坑。模板实例化和 inline 函数在头文件里定义时，即使加了 -fvisibility=hidden，其符号仍可能被生成为全局（尤其是当多个翻译单元都实例化同一模板时）。
立即学习“C++免费学习笔记（深入）”；
- 模板声明本身不产生符号，但每个实例化（如
std::vector<int></int>）会在每个用到它的 .o 文件里生成一份代码 —— 若未强制内联或未设为static，就可能导出重复符号 - 解决方法：把模板定义放在头文件，但用
inline关键字（C++17 起推荐），或显式特化后在 .cpp 里用API_EXPORT导出特定实例 - 对纯头文件库（如某些 utils），可加
#pragma GCC visibility push(hidden)包裹整个头文件，再对真正要导出的模板特化做visibility pop+ 显式标记 - 验证方式：
nm -C libx.so | grep 'vector.*int'，如果看到多个T或W，说明模板泄漏了
为什么加了 -fvisibility=hidden 还报 “undefined reference”？
不是选项没生效，而是导出标记漏了。C++ 名称修饰（name mangling）会让问题更隐蔽：你写了 API_EXPORT void foo(int)，但头文件里声明的是 void foo(double)，编译器生成的符号完全不同，链接时自然找不到。
- 确保头文件声明与实现文件定义**完全一致**（参数类型、const 限定、引用/值传递），尤其注意
std::string和const char*混用 - 检查是否误把
extern "C"套在 C++ 函数上：它禁用 name mangling，但若声明和定义不都在extern "C"块里，符号名会不匹配 - 使用
readelf -Ws lib.so | grep foo查看实际导出的符号名，再用c++filt反解，确认和链接时报错的符号名是否一致 - 如果用 CMake，确认
set(CMAKE_CXX_VISIBILITY_PRESET hidden)已设置，并且所有目标（包括依赖的静态库）都应用了该属性
真正麻烦的不是加 -fvisibility=hidden，而是得通读所有头文件，判断哪些接口真要跨库使用、哪些只是内部胶水；模板和 inline 的处理稍有不慎，就会让隐藏失效或引发 ODR 违规。别信“加了就安全”，得逐个验证导出表。
