C / C++ 调用 DLL 的几种常见方法

9054 2025-12-19 00:55:25

C / C++ 调用 DLL 的几种常见方法(详解 + 示例)

在 Windows 平台开发中,DLL(Dynamic Link Library,动态链接库) 是非常核心的一种代码复用方式。

无论是:

调用第三方 SDK拆分大型工程插件化设计COM / OPC / 工控 / 驱动相关开发

都会不可避免地用到 C / C++ 调用 DLL。

本文将从 零基础视角 出发,系统讲清楚:

DLL 是什么C/C++ 调用 DLL 的 3 种主流方式每种方式的使用场景常见坑点与避坑建议

一、DLL 是什么?(一句话理解)

DLL 是一个“在运行时被加载的函数集合”

和静态库(.lib)的核心区别:

项目DLL静态库链接时间运行时编译期文件.dll + .lib.lib更新可单独替换需重新编译内存多进程共享各自一份

二、最基础示例:先做一个 DLL

1、 编写 DLL 源码

// mydll.h

#pragma once

#ifdef MYDLL_EXPORTS

#define MYDLL_API __declspec(dllexport)

#else

#define MYDLL_API __declspec(dllimport)

#endif

extern "C" MYDLL_API int Add(int a, int b);

// mydll.cpp

#define MYDLL_EXPORTS

#include "mydll.h"

int Add(int a, int b)

{

return a + b;

}

关键点解释:

__declspec(dllexport):导出函数__declspec(dllimport):导入函数extern "C":防止 C++ 名字修饰(非常重要)

2、 编译生成

打开 VS 开发者命令行,在开始菜单中找到并打开:

x64 Native Tools Command Prompt for VS 2022

注意位数:

x86 DLL → 用 x86 Native Toolsx64 DLL → 用 x64 Native Tools

使用 cl.exe 生成 Debug 版 DLL(带 PDB)

最常用 Debug 编译命令(推荐)

cl /LD /Zi /Od /MDd /EHsc mydll.cpp

各参数含义,编译选项参数说明

参数含义/LD生成 DLL/Zi生成调试信息(PDB)/Od关闭优化(便于调试)/MDd使用 Debug CRT(msvcrtd.dll)/EHsc标准 C++ 异常处理(推荐)

D:\test\dll>cl /LD /Zi /Od /MDd /EHsc mydll.cpp

用于 x86 的 Microsoft (R) C/C++ 优化编译器 19.50.35720 版

版权所有(C) Microsoft Corporation。保留所有权利。

mydll.cpp

Microsoft (R) Incremental Linker Version 14.50.35720.0

Copyright (C) Microsoft Corporation. All rights reserved.

/out:mydll.dll

/dll

/implib:mydll.lib

/debug

mydll.obj

D:\test\dll>

编译结果

mydll.dll ← Debug DLL mydll.lib ← 导入库 mydll.pdb ← 调试符号文件(关键)

指定 Debug 输出目录

cl /LD /Zi /Od /MDd mydll.cpp ^

/Fe:Debug\mydll.dll ^

/Fd:Debug\mydll.pdb

生成结果:

Debug\

├── mydll.dll

├── mydll.lib

└── mydll.pdb

Release 版对照

cl /LD /O2 /MD mydll.cpp

DebugRelease/Zi /Od /MDd/O2 /MD有 pdb可选 pdb可单步优化后难调试

编译选项参数说明

最终你会得到:

mydll.dll

mydll.lib

三、方式一:隐式链接(最推荐,最常用)

适用场景

DLL 在开发时就确定SDK / 内部模块不需要动态卸载

1、调用方代码

#include

#include "mydll.h"

int main()

{

int r = Add(2, 3);

std::cout << "result = " << r << std::endl;

return 0;

}

2、工程设置(Visual Studio)

添加 lib:

项目属性链接器 → 输入 → 附加依赖项添加:mydll.lib

放置 dll:

mydll.dll 放在:

exe 同目录或 PATH 目录

优点

语法最简单编译期检查函数签名性能最好

缺点

DLL 缺失 → 程序启动直接失败

四、方式二:显式加载(LoadLibrary / GetProcAddress)

适用场景

插件系统可选功能DLL 可能不存在逆向 / 热更新 / 工控系统常用

示例代码

#include

#include

typedef int (*AddFunc)(int, int);

int main()

{

HMODULE hDll = LoadLibraryA("mydll.dll");

if (!hDll)

{

std::cout << "LoadLibrary failed" << std::endl;

return -1;

}

AddFunc Add = (AddFunc)GetProcAddress(hDll, "Add");

if (!Add)

{

std::cout << "GetProcAddress failed" << std::endl;

FreeLibrary(hDll);

return -1;

}

int r = Add(3, 4);

std::cout << "result = " << r << std::endl;

FreeLibrary(hDll);

return 0;

}

关键注意点

函数名必须是导出名

C++ 函数如果没有 extern "C",名字会被修饰 函数指针签名必须完全一致,可以使用下面的命令查看函数指针签名

dumpbin /exports mydll.dll

调用约定要一致(__cdecl / __stdcall)

优点

程序可在 DLL 缺失时继续运行灵活性极高

缺点

写法复杂容易崩溃(函数签名不匹配)

五、方式三:DLL + .lib,但运行时可选(进阶)

这是 方式一和方式二的混合体:

编译期链接 .lib运行时通过 LoadLibrary 判断是否可用

适合大型工程 / 插件化 SDK。

六、C++ 类如何导出 / 调用?

1、DLL 导出类(示例)

class __declspec(dllexport) MyClass

{

public:

int Add(int a, int b);

};

不推荐直接跨 DLL 导出 C++ 类,原因:

ABI 不稳定编译器 / STL 版本耦合内存管理容易炸

工程实践建议:

DLL 对外只暴露 C 接口,内部再用 C++

七、常见坑点总结(新手必看)

1、忘记 extern “C”

extern "C" __declspec(dllexport) int Func();

否则 GetProcAddress 很容易失败。

2、32 位 / 64 位不匹配

32 位 exe ❌ 加载 64 位 dll会直接 LoadLibrary 失败

用 dumpbin /headers xxx.dll 查看位数

3、 调用约定不一致

__stdcall vs __cdecl

不一致 → 栈损坏 → 程序随机崩溃

4、 DLL 放置路径错误

Windows 查找 DLL 顺序:

exe 同目录系统目录PATH 环境变量

八、如何查看 DLL 导出函数?(实用技巧)

dumpbin /exports mydll.dll

可以看到:

函数名序号是否被修饰

这是调试 GetProcAddress 的神器。

九、实际工程建议(经验总结)

新项目:优先 extern “C” + 隐式链接插件系统:显式加载不要跨 DLL 传 STL 容器不要在不同 CRT 中 free 内存

十、总结一句话

DLL 是 Windows 下模块化的核心能力, 会用 DLL,才算真正进入 C/C++ 工程开发。

盆栽桔子树的养殖方法,夏季要注意喷水降温
天然气12t是什么意思