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

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 # 头文件 # 加载 # 主程序 # 或用 # 找不到 # 两种 # 只需 # 这不是 # 都用 # 不加

返回目录在线咨询

上一篇：Xshell中常见SSH连接错误及解决方法
下一篇：如何使用C#在PDF文件添加图片印章

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

全网整合营销服务商

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

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

ifdef _WIN32

ifdef MATH_UTILS_EXPORTS

else

endif

else

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

endif

ifdef __cplusplus

endif

二、编译生成动态库

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

四、注意事项与常见问题

您的项目需求