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

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）

头文件与使用方注意事项

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

• 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

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