使用-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）。

visibility 对模板和内联函数的影响

模板声明本身不生成符号，但显式实例化或使用时会生成具体函数/静态数据。若未显式导出：

• 模板函数默认不导出（即使在 EXPORT 类里定义），除非该函数被显式实例化并标记 EXPORT
• 类内 inline 函数受类 visibility 控制；类外定义的 inline 函数需单独加 EXPORT 才能导出
• 静态数据成员（如 template T MyClass::s_value;）必须显式导出，否则链接时报 undefined reference

常见误用和排查技巧

导出后仍找不到符号？可能是这些原因：

• 忘记加 -fvisibility=hidden 编译选项（仅加 attribute 不生效）
• 头文件中声明没加 attribute，而定义处加了——声明和定义 visibility 必须一致
• 用了 extern "C" 但没同步处理 visibility（C 链接函数也要加 EXPORT）
• 用 nm -D libxxx.so 或 objdump -T 检查实际导出符号，确认名字是否 mangling 正确