C++动态加载DLL/SO需运行时调用系统API:Windows用LoadLibrary/GetProcAddress,Linux用dlopen/dlsym;均需显式类型转换函数指针、正确导出符号(extern "C" __declspec(dllexport))、配对卸载,并注意路径、位数及签名匹配。

C++ 加载和调用动态链接库(Windows 的 DLL 或 Linux 的 SO)主要靠运行时动态加载机制:Windows 用 LoadLibrary / GetProcAddress,Linux 用 dlopen / dlsym。核心思路是——不链接 .lib/.a,而是在程序运行时打开库文件,手动获取函数地址并调用。
Windows 下加载 DLL(使用 WinAPI)
需包含 ,确保 DLL 文件在可搜索路径(如当前目录、系统路径或 PATH 中)。
- 用
LoadLibrary打开 DLL,返回模块句柄(HMODULE) - 用
GetProcAddress根据函数名获取函数指针,注意类型强转 - 调用完成后用
FreeLibrary卸载(非必须,但推荐)
示例(假设 DLL 中导出一个 int add(int, int) 函数):
#include#include typedef int (*AddFunc)(int, int);
立即学习“C++免费学习笔记(深入)”;
int main() { HMODULE hDll = LoadLibrary(L"mylib.dll"); if (!hDll) { std::cerr << "Failed to load DLL\n"; return -1; }
AddFunc add = (AddFunc)GetProcAddress(hDll, "add"); if (!add) { std::cerr << "Failed to get function address\n"; FreeLibrary(hDll); return -1; } std::cout << "Result: " << add(3, 5) << "\n"; // 输出 8 FreeLibrary(hDll); return 0;}
⚠️ 注意:DLL 中的函数需用 extern "C" __declspec(dllexport) 导出,避免 C++ 名字修饰干扰;若用 C++ 成员函数或重载函数,需额外封装为 C 风格接口。
Linux 下加载 SO(使用 libdl)
需链接 -ldl,头文件为 ,SO 文件路径支持相对或绝对路径(如 "./libmylib.so")。
- 用
dlopen打开共享库,返回void*句柄 - 用
dlsym获取符号地址,同样需显式类型转换 - 出错时用
dlerror()获取错误信息 - 用
dlclose卸载(非强制,但建议配对使用)
示例(对应同一 add 函数):
#include#include typedef int (*AddFunc)(int, int);
立即学习“C++免费学习笔记(深入)”;
int main() { void* handle = dlopen("./libmylib.so", RTLD_LAZY); if (!handle) { std::cerr << "dlopen failed: " << dlerror() << "\n"; return -1; }
AddFunc add = (AddFunc)dlsym(handle, "add"); const char* error = dlerror(); if (error) { std::cerr << "dlsym failed: " << error << "\n"; dlclose(handle); return -1; } std::cout << "Result: " << add(3, 5) << "\n"; dlclose(handle); return 0;}
⚠️ 编译命令:g++ main.cpp -ldl -o main;SO 文件需已存在且有执行权限(通常默认满足)。
跨平台封装小技巧(简化调用)
为减少重复判断,可封装一个轻量类或宏。例如定义统一的句柄类型:
#ifdef _WIN32
#include
using LibHandle = HMODULE;
#define LOAD_LIB(name) LoadLibrary(TEXT(name))
#define GET_PROC(h, name) GetProcAddress((h), (name))
#define FREE_LIB(h) FreeLibrary(h)
#else
#include
using LibHandle = void*;
#define LOAD_LIB(name) dlopen((name), RTLD_LAZY)
#define GET_PROC(h, name) dlsym((h), (name))
#define FREE_LIB(h) dlclose(h)
#endif
后续代码只需操作 LibHandle 和统一宏,逻辑更清晰。实际项目中也可用 CMake 的 find_library 或 target_link_libraries 配合 IMPORTED 目标做更高级管理。
常见问题与避坑点
- DLL/SO 文件未找到:检查路径、拼写、位数匹配(32/64 位程序只能加载同位数库)
- 函数找不到:确认导出符号名正确(可用
dumpbin /exports(Win)或nm -D(Linux)查看) - 调用崩溃:函数签名不匹配(参数/返回值类型或调用约定错误),务必 typedef 显式声明
- 内存泄漏风险:每次
LoadLibrary/dlopen应配对FreeLibrary/dlclose,尤其在循环或插件系统中
不复杂但容易忽略细节,关键是把“加载→查符号→转类型→调用→卸载”这五步走稳。










