在 Windows 平台开发动态链接库(DLL)时,需要用到__declspec(dllexport)
和 __declspec(dllimport)
是关键字,用于显式控制符号(函数、类、变量)的导出和导入。以下是详细说明:
1. __declspec(dllexport)
作用
- 标记导出符号:在 DLL 源代码中标记需要公开的函数、类或全局变量,使其可被其他程序调用。
- 生成导出表:编译器会在生成的
.lib
(导入库)和 DLL 文件中创建导出表,记录符号名称和地址。
使用场景
// 在 DLL 项目中使用
__declspec(dllexport) void ExportFunction(); // 导出函数
__declspec(dllexport) int globalVar; // 导出全局变量
// 导出类(所有成员函数自动导出)
class __declspec(dllexport) MyExportedClass {
public:
void Method();
};
编译器行为
- 将符号加入 DLL 的导出表。
- 生成对应的
.lib
文件(供调用方使用)。
2. __declspec(dllimport)
作用
- 标记导入符号:在调用 DLL 的程序中声明外部符号来自 DLL。
- 优化调用效率(关键!):
- 函数调用:编译器生成直接跳转指令,避免通过指针表间接调用。
- 变量访问:直接通过全局指针访问,减少寻址开销。
- 提高代码可读性:明确标识外部依赖。
使用场景
// 在调用 DLL 的程序中使用
__declspec(dllimport) void ImportFunction(); // 导入函数
__declspec(dllimport) extern int globalVar; // 导入全局变量
// 导入类声明
class __declspec(dllimport) MyImportedClass {
public:
void Method();
};
3. 统一头文件的技巧
通过预处理器宏实现头文件在 DLL 和调用方通用:
// 示例: MyDll.h
#ifdef MYDLL_EXPORTS
#define MYDLL_API __declspec(dllexport) // 编译 DLL 时定义
#else
#define MYDLL_API __declspec(dllimport) // 调用方使用
#endif
MYDLL_API void Foo(); // 函数导出/导入
class MYDLL_API MyClass { ... }; // 类导出/导入
extern MYDLL_API int globalVar; // 变量导出/导入
DLL 项目配置:
- 添加预处理器定义
MYDLL_EXPORTS
(在 VS 中通过项目属性设置)。
4. 重要注意事项
-
变量必须用
extern
导入全局变量时需声明为extern
:extern __declspec(dllimport) int globalVar;
-
C++ 名称修饰(Name Mangling)
- C++ 导出函数会因编译器不同被修饰(如
?Foo@@YAXXZ
)。 - 解决方案:
使用extern "C"
禁止修饰(但无法导出类):extern "C" __declspec(dllexport) void Foo();
- C++ 导出函数会因编译器不同被修饰(如
总结
关键字 | 使用位置 | 目的 |
---|---|---|
__declspec(dllexport) | DLL 源代码 | 将符号加入导出表 |
__declspec(dllimport) | 调用方程序 | 声明外部符号并优化调用/访问 |