讲师中心 微信公众号
AI工具推荐 视频效率加速

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

胖敏同学_9042

胖敏同学_9042

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

|

640人浏览过

|

来源于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++免费学习笔记(深入)”;

Linux Journey
Linux Journey

当用户想学习Linux基础、命令行、文件系统等时,在LabEx查找并推荐免费的Linux Journey课程。

下载
#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<int> 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 不是“编译开关”,而是每个符号的独立属性,写错位置或漏写一个,就可能让整个接口不可用。

相关文章

.dll文件大全
.dll文件大全

.dll文件缺失怎么办?.dll文件在哪下载?不用担心,这里为大家提供了所有的.dll文件下载,无论用户丢失的是什么.dll文件,在这里都能找到。用户保存后,在网盘搜索dll文件全称即可查找下载!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

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

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

509

2023.09.22

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

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

1638

2024.03.01

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

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

3645

2025.09.18

python 全局变量
python 全局变量

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

1490

2025.09.18

c++ 全局变量
c++ 全局变量

本专题整合了c++全局变量的使用、定义、作用域等等内容,阅读专题下面的文章了解更多详细内容。

179

2026.03.17

string转int
string转int

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

5139

2023.08.02

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

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

2625

2024.08.29

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

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

3208

2025.08.29

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

0

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn