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

Windows用LoadLibrary+GetProcAddress,Linux用dlopen+dlsym实现运行时动态加载;需注意函数导出(__declspec(dllexport)/__attribute__((visibility("default"))))、类型安全调用、跨平台封装、路径与符号可见性、内存管理边界等关键点。

Windows 下用 LoadLibrary + GetProcAddress,Linux 下用 dlopen + dlsym。核心是运行时加载、获取函数地址、类型安全调用。

Windows:用 LoadLibrary 加载 DLL

需要头文件 #include windows.h>,DLL 导出函数需用 __declspec(dllexport)(编译 DLL 时),调用方用 typedef 声明函数指针类型,再通过 GetProcAddress 获取地址。

示例(调用一个 int add(int, int) 函数):

  • 先定义函数指针类型:typedef int (*AddFunc)(int, int);
  • 加载 DLL:HMODULE hDll = LoadLibrary(L"mylib.dll");
  • 获取函数地址:AddFunc add = (AddFunc)GetProcAddress(hDll, "add");
  • 检查并调用:if (add) { int r = add(3, 5); }
  • 用完释放:FreeLibrary(hDll);

Linux:用 dlopen 加载 SO

需链接 -ldl,头文件 #include 。SO 中函数默认可见,但建议加 __attribute__((visibility("default"))) 显式导出。

示例(同样调用 add 函数):

  • 定义函数指针:typedef int (*AddFunc)(int, int);
  • 打开共享库:void* handle = dlopen("./libmylib.so", RTLD_LAZY);
  • 获取符号:AddFunc add = (AddFunc)dlsym(handle, "add");
  • 检查错误:const char* err = dlerror(); if (err) { /* 处理 */ }
  • 调用后关闭:dlclose(handle);

跨平台封装小技巧

可用宏隔离差异,让业务代码统一:

  • 定义统一句柄类型:#ifdef _WIN32
      using LibHandle = HMODULE;
    #else
      using LibHandle = void*;
    #endif
  • 封装加载/查找/卸载函数,内部按平台分支处理
  • 务必检查返回值(NULL / nullptr / INVALID_HANDLE_VALUE),避免崩溃
  • 函数签名必须严格一致,C++ 重载名会 mangling,DLL/SO 中导出推荐用 extern "C" 防止

常见坑和注意点

  • DLL 路径问题:Windows 默认只在系统路径、当前目录、PATH 中找;可用绝对路径或 SetDllDirectory
  • SO 依赖:用 ldd libmylib.so 查依赖,确保运行时能解析
  • 类对象不能直接跨模块传递:只传 C 风格函数或纯虚接口(如 COM/抽象基类 + 工厂函数)
  • 内存管理:谁分配谁释放;避免在 DLL 中 new、在主程序中 delete(可能用不同堆)

基本上就这些。不复杂但容易忽略路径、符号可见性、调用约定和内存边界。