C++如何加载和调用动态链接库(DLL/SO)?(代码示例)

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);

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);

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_librarytarget_link_libraries 配合 IMPORTED 目标做更高级管理。

常见问题与避坑点

  • DLL/SO 文件未找到:检查路径、拼写、位数匹配(32/64 位程序只能加载同位数库)
  • 函数找不到:确认导出符号名正确(可用 dumpbin /exports(Win)或 nm -D(Linux)查看)
  • 调用崩溃:函数签名不匹配(参数/返回值类型或调用约定错误),务必 typedef 显式声明
  • 内存泄漏风险:每次 LoadLibrary/dlopen 应配对 FreeLibrary/dlclose,尤其在循环或插件系统中

不复杂但容易忽略细节,关键是把“加载→查符号→转类型→调用→卸载”这五步走稳。