使用-fvisibility=hidden默认隐藏符号，仅用__attribute__((visibility("default")))显式导出必要接口，可避免冲突、减小体积、提升加载速度；需声明与定义visibility一致，并注意模板、内联函数及静态成员的显式导出。
控制动态库中符号的导出与隐藏，避免命名冲突、减小二进制体积、提升加载速度。默认情况下，C++ 编译后所有非静态全局符号（函数、变量、类）在动态库中都是“可见”的（即可被外部链接），这容易导致符号污染、意外重定义，也增加动态链接器负担。__attribute__((visibility)) 是 GCC/Clang 提供的机制，用于精细控制每个符号在共享库中的可见性。
visibility=hidden 是最常用且推荐的默认策略
在编译动态库时，加上 -fvisibility=hidden，会让所有符号默认不可见；再用 __attribute__((visibility("default"))) 显式标记需要对外暴露的接口。这样做的好处是：
- 只有你明确想导出的函数/类才出现在动态符号表里，避免内部辅助函数、模板实例、匿名命名空间外泄
- 减少动态库体积（尤其对含大量模板或内联代码的库）
- 加快 dlopen/dlsym 加载和符号解析速度
- 防止第三方链接时意外覆盖你的弱符号或同名静态变量
如何正确标记需要导出的符号
通常配合宏使用，兼顾跨平台和可读性：
#ifdef __GNUC__
# define EXPORT __attribute__((visibility("default")))
# define HIDDEN __attribute__((visibility("hidden")))
#else
# define EXPORT
# define HIDDEN
#endif
class EXPORT MyPublicClass { / ... / };
EXPORT void public_api(int x);
static void HIDDEN helper_func(); // 即使不加 hidden，-fvisibility=hidden 下它也自动隐藏
注意：类方法若在类体内定义（隐式 inline），需对整个类加 EXPORT；若在类外定义，需对每个成员函数单独加（或继承类的 visibility）。
立即学习“C++免费学习笔记（深入）”；
visibility 对模板和内联函数的影响
模板声明本身不生成符号，但显式实例化或使用时会生成具体函数/静态数据。若未显式导出：
- 模板函数默认不导出（即使在
EXPORT类里定义），除非该函数被显式实例化并标记EXPORT - 类内
inline函数受类 visibility 控制；类外定义的inline函数需单独加EXPORT才能导出 - 静态数据成员（如
template）必须显式导出，否则链接时报 undefined referenceT MyClass ::s_value;
常见误用和排查技巧
导出后仍找不到符号？可能是这些原因：
- 忘记加
-fvisibility=hidden编译选项（仅加 attribute 不生效） - 头文件中声明没加 attribute，而定义处加了——声明和定义 visibility 必须一致
- 用了
extern "C"但没同步处理 visibility（C 链接函数也要加EXPORT） - 用
nm -D libxxx.so或objdump -T检查实际导出符号，确认名字是否 mangling 正确
