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

在 C++ 中生成动态库(Linux 下为 .so,Windows 下为 .dll),核心是用编译器导出符号,并控制链接方式。关键不在于“写代码”,而在于“怎么告诉编译器:这些函数我要给别人用”。
Linux 下生成 .so 动态库
需两步:编译为位置无关代码(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 下生成 .dll 动态库(MSVC 或 MinGW)
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)
头文件与使用方注意事项
调用动态库的程序必须有对应头文件,且链接时指定库路径和名字。
立即学习“C++免费学习笔记(深入)”;
- 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 示例)
用 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
不复杂但容易忽略:导出符号、位置无关、头文件一致性 —— 抓住这三点,动态库就稳了。











