0

0

c++的动态库(.so/.dll)符号可见性如何控制? (__attribute__((visibility("default"))))

裘德小鎮的故事

裘德小鎮的故事

发布时间:2026-01-10 12:15:54

|

580人浏览过

|

来源于php中文网

原创

Linux下.so默认隐藏所有符号,需用__attribute__((visibility("default")))显式导出类、函数等;Windows需用__declspec(dllexport),跨平台应以宏隔离;声明处(非实现处)加属性,基类与虚函数必须导出以支持dynamic_cast和RTTI。

c++的动态库(.so/.dll)符号可见性如何控制? (__attribute__((visibility(\

Linux 下 .so 默认隐藏所有符号,不加显式声明就找不到

GNU 工具链(gcc/g++)编译动态库时,默认启用 -fvisibility=hidden(即使你没写)。这意味着:所有函数、类、全局变量默认**不导出**,外部可执行文件或其它库 dlsym 找不到,链接时报 undefined reference 或运行时报 symbol not found

必须对需要暴露的符号手动加 __attribute__((visibility("default"))),否则它们只在本 .so 内部可见。

  • 类定义需加在类声明前:class __attribute__((visibility("default"))) MyClass { ... };
  • 自由函数同理:extern "C" __attribute__((visibility("default"))) int my_func();
  • C++ 成员函数自动继承类的 visibility 属性,但虚表(vtable)、RTTI 信息也受此控制——类设为 default 才能被 dynamic_cast 跨库使用
  • 头文件中建议用宏封装,避免重复写长属性:
    #define EXPORT __attribute__((visibility("default")))

Windows 的 .dll 不靠 visibility,而依赖 __declspec(dllexport)

__attribute__((visibility(...))) 在 Windows(MSVC/MinGW)上**基本无效**。MinGW 可能部分支持,但行为不一致;MSVC 完全忽略它。Windows 动态库必须用 __declspec(dllexport) 显式导出,或通过 .def 文件列出符号。

跨平台项目常用条件宏隔离:

立即学习C++免费学习笔记(深入)”;

播记
播记

播客shownotes生成器 | 为播客创作者而生

下载
#ifdef _WIN32
    #define EXPORT __declspec(dllexport)
#else
    #define EXPORT __attribute__((visibility("default")))
#endif

注意:MSVC 下若未加 __declspec(dllexport),即使链接时不报错,运行时调用也会失败(GetProcAddress 返回 NULL)。

头文件里声明和实现位置影响 visibility 生效范围

visibility 属性必须作用于**定义处**(即符号首次被声明/定义的地方),不是调用处。常见错误是只在实现文件(.cpp)里加属性,但头文件中类/函数声明没加——此时编译器仍按默认 hidden 处理头文件里的声明,导致 ODR 违反或链接失败。

  • 正确做法:在头文件中声明时就加上 EXPORT 宏(如 class EXPORT MyClass;
  • 若头文件被多个模块包含,且只想让某模块导出,需用预处理控制:#ifdef BUILDING_MYLIB + EXPORT,否则其他模块包含该头文件会意外导出符号
  • 模板函数/类不能直接加 EXPORT(实例化发生在使用点),需显式实例化并导出:
    template EXPORT std::vector make_vec();

忘记导出虚函数或纯虚基类会导致 dynamic_cast 跨库失效

C++ RTTI(类型信息)和虚函数表(vtable)的可见性由类本身的 visibility 控制。如果基类没加 EXPORT,即使派生类加了,dynamic_cast 从派生类指针转回基类时仍可能返回 nullptr(尤其在不同 .so 间传递对象时)。

典型症状:调试时发现 typeid(obj).name() 输出乱码,或 dynamic_cast 总失败,但静态类型检查无误。

  • 基类必须 EXPORT,且所有虚函数(包括析构函数)都隐含受控
  • 若基类在另一库中已导出,当前库只需确保继承时不用重新定义 vtable(即不覆写虚函数时可省略导出,但安全起见仍建议显式标注)
  • Clang/GCC 提供 -Wmissing-field-initializers 类似警告不覆盖 visibility,需靠 -Wattributes 检查 visibility 是否遗漏
实际项目里最容易漏的是头文件中的类声明、基类、以及跨库传递对象时的 RTTI 依赖。visibility 不是“编译开关”,而是每个符号的独立属性,写错位置或漏写一个,就可能让整个接口不可用。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

231

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

435

2024.03.01

全局变量怎么定义
全局变量怎么定义

本专题整合了全局变量相关内容,阅读专题下面的文章了解更多详细内容。

73

2025.09.18

python 全局变量
python 全局变量

本专题整合了python中全局变量定义相关教程,阅读专题下面的文章了解更多详细内容。

96

2025.09.18

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

315

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

533

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

51

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

193

2025.08.29

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

25

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 6.9万人学习

Git 教程
Git 教程

共21课时 | 2.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号