c++如何编译成动态库 c++ .so/.dll文件生成【教程】_网络技术

发布时间 - 2025-12-27 00:00:00 点击率：次

C++动态库生成核心是导出符号与控制链接：Linux用-fPIC和-shared生成.so，Windows需__declspec(dllexport)声明导出；须注意头文件一致性、位置无关代码及跨平台兼容性。

在 C++ 中生成动态库（Linux 下为 .so，Windows 下为 .dll），核心是用编译器导出符号，并控制链接方式。关键不在于“写代码”，而在于“怎么告诉编译器：这些函数我要给别人用”。

需两步：编译为位置无关代码（PIC），再链接成共享对象。

源文件（math_utils.cpp）中，无需特殊关键字；C++ 默认所有非 static 全局函数/变量都可导出（但建议显式控制）
加 -fPIC 编译目标文件：
g++ -fPIC -c math_utils.cpp -o math_utils.o
用 -shared 链接生成 .so：
g++ -shared -o libmath_utils.so math_utils.o
若要隐藏未声明为 extern "C" 的 C++ 符号（避免 name mangling），或控制可见性，可在头文件中加：
#define EXPORT __attribute__((visibility("default")))，并在函数前加 EXPORT

Windows 要求显式声明导出符号，否则链接器看不到函数。

方法一（推荐，跨编译器兼容）：用 __declspec(dllexport) 标记导出函数
头文件 math_utils.h 中：

#ifdef BUILDING_DLL
#define DLL_EXPORT __declspec(dllexport)
#else
#define DLL_EXPORT __declspec(dllimport)
#endif
DLL_EXPORT int add(int a, int b);

编译时定义 BUILDING_DLL：
cl /c /DBUILDING_DLL math_utils.cpp（MSVC）
或 g++ -c -DBUILDING_DLL math_utils.cpp（MinGW）
链接生成 DLL：
link /DLL /OUT:math_utils.dll math_utils.obj（MSVC）
或 g++ -shared -o math_utils.dll math_utils.o（MinGW）

调用动态库的程序必须有对应头文件，且链接时指定库路径和名字。

Linux 使用时：
编译： g++ main.cpp -L. -lmath_utils -o main
运行前确保 LD_LIBRARY_PATH 包含 .，或把 .so 放到系统路径
Windows 使用时：
链接： g++ main.cpp -L. -lmath_utils -o main.exe（MinGW）
注意：.dll 必须和 .exe 在同一目录，或在 PATH 中
C++ 类导出较复杂，建议只导出 C 风格函数（extern "C"），或用工厂函数返回抽象接口指针

用 CMake 可统一管理跨平台构建：

add_library(math_utils SHARED math_utils.cpp)
设置属性让所有符号默认导出（Linux）：
set_target_properties(math_utils PROPERTIES POSITION_INDEPENDENT_CODE ON)
Windows 下自动加 dllexport 宏：
target_compile_definitions(math_utils PRIVATE BUILDING_DLL)
生成后用 cmake --build . 即可产出 .so 或 .dll

不复杂但容易忽略：导出符号、位置无关、头文件一致性 —— 抓住这三点，动态库就稳了。