c++如何编写动态链接库(DLL/so)_c++共享库的创建与使用【教程】

发布时间 - 2025-12-25 00:00:00    点击率:
C++动态库需跨平台导出符号:Windows用__declspec(dllexport/import),Linux/macOS用__attribute__((visibility("default")))配合-fvisibility=hidden;编译时Windows用cl /LD,Linux用g++ -shared -fPIC,macOS用clang++ -dynamiclib -fPIC;调用支持静态链接或动态加载。

在 C++ 中编写动态链接库(Windows 下叫 DLL,Linux/macOS 下叫 shared object,即 .so.dylib),核心是导出函数/类供外部调用,同时注意平台差异和编译链接方式。下面分步骤讲清楚怎么创建、编译、使用。

一、编写可导出的 C++ 代码

动态库不是直接运行的程序,而是提供功能的“工具箱”。关键是要明确哪些符号(函数、类)需要被外部看到。

  • Windows(DLL):用 __declspec(dllexport) 标记要导出的函数或类;用 __declspec(dllimport) 在调用端声明(通常用宏自动切换)
  • Linux/macOS(.so):默认隐藏所有符号,用 __attribute__((visibility("default"))) 显式标记要导出的符号(推荐开启 -fvisibility=hidden 编译选项提升安全性)

示例(跨平台写法,头文件 math_utils.h):

#ifdef __cplusplus
extern "C" {
#endif

ifdef _WIN32

ifdef MATH_UTILS_EXPORTS

#define MATH_API __declspec(dllexport)

else

#define MATH_API __declspec(dllimport)

endif

else

define MATH_API attribute((visibility("default")))

endif

MATH_API int add(int a, int b); MATH_API int multiply(int a, int b);

ifdef __cplusplus

}

endif

实现文件 math_utils.cpp 只需普通实现,不加额外修饰:

#include "math_utils.h"
int add(int a, int b) { return a + b; }
int multiply(int a, int b) { return a * b; }

二、编译生成动态库

命令依赖编译器和平台,但逻辑一致:告诉编译器“这不是可执行程序,是共享库”,并处理符号可见性。

  • Windows(MSVC,命令行):
    cl /LD /Fe:math_utils.dll math_utils.cpp
    /LD 表示生成 DLL,/Fe: 指定输出名)
  • Linux(g++/clang):
    g++ -fPIC -shared -fvisibility=hidden -o libmath_utils.so math_utils.cpp
    -fPIC 生成位置无关码,-shared 生成 so,-fvisibility=hidden 配合头文件中的 visibility("default") 控制导出)
  • macOS(clang):
    clang++ -dynamiclib -fPIC -fvisibility=hidden -o libmath_utils.dylib math_utils.cpp

三、在主程序中调用动态库

分两种方式:静态链接(编译时绑定)、动态加载(运行时加载)。前者简单常用,后者更灵活(比如插件系统)。

  • 静态链接方式(推荐初学)
    写主程序 main.cpp,包含头文件并直接调用函数:
    #include "math_utils.h"
    #include 
    int main() {
        std::cout << add(3, 4) << "\n";        // 输出 7
        std::cout << multiply(3, 4) << "\n";    // 输出 12
    }
    编译时链接库:
    Windows:cl main.cpp /link math_utils.lib
    Linux:g++ main.cpp -L. -lmath_utils -o main(假libmath_utils.so 在当前目录)
    macOS:clang++ main.cpp -L. -lmath_utils -o main
  • 动态加载方式(跨平台需封装)
    Windows 用 LoadLibrary + GetProcAddress
    Linux/macOS 用 dlopen + dlsym
    优点是无需编译时依赖库文件,支持热插拔;缺点是手动管理符号、类型安全弱、易出错。

四、注意事项与常见问题

  • 避免导出 C++ 类的完整定义(尤其含 STL 成员)——不同编译器/标准库 ABI 不兼容。建议只导出 C 风格函数,或用 PIMPL + 工厂函数封装类
  • Windows DLL 要确保运行时一致(如都用 MT 或 MD 链接 CRT),否则可能崩溃
  • Linux 下运行时报 “xxx: cannot open shared object file”:检查 LD_LIBRARY_PATH 是否包含库路径,或用 ldd ./main 查依赖
  • 导出 C++ 函数名会被编译器修饰(mangling),所以 C 接口必须用 extern "C" 包裹,否则调用端找不到符号

基本上就这些。写动态库不复杂,关键是理解“导出控制”和“链接时机”两个核心点。从写头文件开始,统一宏定义,再按平台编译,最后链接调用——流程清晰,一次搞定。


# linux  # windows  # 工具  # mac  # ai  # c++  # macos  # win  # cos  # lsp  # red  # Object  # 封装  # extern  # int  # 接口  # Attribute  # default  # 头文件  # 加载  # 主程序  # 或用  # 找不到  # 两种  # 只需  # 这不是  # 都用  # 不加 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 如何在宝塔面板中修改默认建站目录?  PHP 500报错的快速解决方法  javascript日期怎么处理_如何格式化输出  Laravel API资源(Resource)怎么用_格式化Laravel API响应的最佳实践  Laravel如何处理文件下载请求?(Response示例)  家族网站制作贴纸教程视频,用豆子做粘帖画怎么制作?  Laravel观察者模式如何使用_Laravel Model Observer配置  原生JS实现图片轮播切换效果  如何在Windows环境下新建FTP站点并设置权限?  Laravel如何实现用户注册和登录?(Auth脚手架指南)  大连网站制作费用,大连新青年网站,五年四班里的视频怎样下载啊?  JavaScript如何操作视频_媒体API怎么控制播放  ChatGPT怎么生成Excel公式_ChatGPT公式生成方法【指南】  高端建站三要素:定制模板、企业官网与响应式设计优化  网站制作大概多少钱一个,做一个平台网站大概多少钱?  php json中文编码为null的解决办法  如何用西部建站助手快速创建专业网站?  Laravel队列由Redis驱动怎么配置_Laravel Redis队列使用教程  Laravel如何配置Horizon来管理队列?(安装和使用)  Bootstrap整体框架之CSS12栅格系统  如何用腾讯建站主机快速创建免费网站?  英语简历制作免费网站推荐,如何将简历翻译成英文?  千库网官网入口推荐 千库网设计创意平台入口  进行网站优化必须要坚持的四大原则  Win11怎么查看显卡温度 Win11任务管理器查看GPU温度【技巧】  网站优化排名时,需要考虑哪些问题呢?  详解Nginx + Tomcat 反向代理 负载均衡 集群 部署指南  高性能网站服务器部署指南:稳定运行与安全配置优化方案  nodejs redis 发布订阅机制封装实现方法及实例代码  js实现获取鼠标当前的位置  Laravel如何生成URL和重定向?(路由助手函数)  如何快速搭建FTP站点实现文件共享?  晋江文学城电脑版官网 晋江文学城网页版直接进入  Laravel如何集成Inertia.js与Vue/React?(安装配置)  Bootstrap CSS布局之列表  Win11怎样安装网易有道词典_Win11安装词典教程【步骤】  Laravel怎么配置S3云存储驱动_Laravel集成阿里云OSS或AWS S3存储桶【教程】  如何在阿里云ECS服务器部署织梦CMS网站?  如何用PHP快速搭建高效网站?分步指南  Laravel如何保护应用免受CSRF攻击?(原理和示例)  大连 网站制作,大连天途有线官网?  JavaScript中如何操作剪贴板_ClipboardAPI怎么用  如何在IIS管理器中快速创建并配置网站?  制作ppt免费网站有哪些,有哪些比较好的ppt模板下载网站?  如何快速搭建自助建站会员专属系统?  如何在建站主机中优化服务器配置?  ,在苏州找工作,上哪个网站比较好?  Midjourney怎样加参数调细节_Midjourney参数调整技巧【指南】  Laravel Eloquent关联是什么_Laravel模型一对一与一对多关系精讲  大型企业网站制作流程,做网站需要注册公司吗?