创建动态库需分离接口与实现,Windows用.dll、Linux/macOS用.so/.dylib;关键步骤包括:一、头文件中用宏统一声明导出符号(Windows需__declspec(dllexport/import),Linux/macOS推荐__attribute__((visibility("default")))并加extern "C"防名字修饰);二、实现代码后编译为目标文件(Linux/macOS须加-fPIC);三、链接生成动态库(Windows用link /DLL,Linux用g++ -shared,macOS用clang++ -dynamiclib);四、通过链接或运行时加载使用。

创建动态库的关键是分离接口与实现,用编译器导出符号,并按平台规范链接生成二进制文件。Windows 用 .dll,Linux/macOS 用 .so(或 .dylib),但核心流程相似。
一、准备源码:声明导出符号(Windows 必须,Linux 可选)
Windows DLL 需显式标记哪些函数/类对外可见;Linux 默认全局符号都可被链接,但建议加 __attribute__((visibility("default"))) 显式控制。
常见做法是用宏统一处理:
- Windows:定义
MYLIB_EXPORT宏,展开为__declspec(dllexport)(编译时)或__declspec(dllimport)(使用时) - Linux/macOS:定义为
__attribute__((visibility("default"))),未标注的默认隐藏(推荐)
示例头文件 mylib.h:
立即学习“C++免费学习笔记(深入)”;
#ifndef MYLIB_H #define MYLIB_Hifdef _WIN32
ifdef MYLIB_BUILD
#define MYLIB_API __declspec(dllexport)else
#define MYLIB_API __declspec(dllimport)endif
else
define MYLIB_API attribute((visibility("default")))
endif
extern "C" { MYLIB_API int add(int a, int b); MYLIB_API int multiply(int a, int b); }
endif
注意:C++ 函数名会因编译器而修饰(name mangling),加 extern "C" 可保持 C 风格符号名,方便跨语言调用或避免链接错误。
二、实现代码并编译成目标文件
写好 mylib.cpp,实现头文件中声明的函数:
#include "mylib.h"int add(int a, int b) { return a + b; } int multiply(int a, int b) { return a * b; }
分别编译(不链接):
- Windows(MSVC):
cl /c /EHsc /DMYLIB_BUILD mylib.cpp→ 生成mylib.obj - Linux(g++/clang):
g++ -fPIC -c -DMYLIB_BUILD -o mylib.o mylib.cpp - macOS:
clang++ -fPIC -c -DMYLIB_BUILD -o mylib.o mylib.cpp
关键点:-fPIC(Position Independent Code)在 Linux/macOS 是必须的;Windows DLL 默认支持重定位,无需额外标志。
三、链接生成动态库文件
用目标文件链接出最终动态库:
- Windows(MSVC):
link /DLL /OUT:mylib.dll mylib.obj - Linux:
g++ -shared -o libmylib.so mylib.o - macOS:
clang++ -dynamiclib -o libmylib.dylib mylib.o
Linux 下也可加 -Wl,-soname,libmylib.so.1 设置 soname,便于版本管理;macOS 推荐加 -install_name @rpath/libmylib.dylib 方便运行时查找。
四、使用动态库(简单验证)
写一个测试程序 main.cpp:
#include#include "mylib.h" int main() { std::cout << add(3, 5) << "\n"; // 输出 8 std::cout << multiply(4, 6) << "\n"; // 输出 24 }
编译并运行:
- Windows:
cl main.cpp /link mylib.lib(需先用lib工具从 DLL 生成 .lib 导入库),然后把mylib.dll放到 exe 同目录或系统 PATH 中 - Linux:
g++ main.cpp -L. -lmylib -o main && LD_LIBRARY_PATH=. ./main - macOS:
clang++ main.cpp -L. -lmylib -o main && DYLD_LIBRARY_PATH=. ./main
如果提示找不到库,检查路径、权限(Linux/macOS)、是否遗漏 -fPIC 或导出宏定义。
基本上就这些。核心是:头文件控制可见性、源码加导出标记、编译加位置无关选项、链接用共享模式。不复杂但容易忽略细节,比如 Windows 的 dllimport 和 Linux 的 -fPIC。











