根本原因是__declspec(dllexport)必须仅在DLL工程编译时生效，若被调用方误用会导致LNK2005重复定义；且类导出受编译器、运行时、STL版本差异影响vtable布局，极易崩溃。
为什么 __declspec(dllexport) 在跨项目时经常失效
根本原因不是语法写错了，而是 DLL 的符号导出发生在链接阶段，而头文件里的 __declspec(dllexport) 宏定义必须被**导出项目（DLL 工程）编译时**看到，且不能被调用方（EXE 或其他 DLL）误用。常见错误是把同一份头文件直接扔进两个工程，没做宏开关隔离。
实操建议：
- 在 DLL 工程的预处理器定义中添加
BUILDING_MYLIB（或类似标识） - 头文件中用条件宏控制导出/导入：
#ifdef BUILDING_MYLIB #define MYLIB_API __declspec(dllexport) #else #define MYLIB_API __declspec(dllimport) #endif - 确保 DLL 工程编译时定义了该宏，而调用方**不定义**——否则会试图导出本不该导出的符号，链接时报
LNK2005重复定义 - 类成员函数、全局变量、模板函数都不能直接用
__declspec(dllexport)导出（模板需显式实例化）
类导出时虚函数表和 ABI 兼容性崩塌的真实原因
导出一个类，本质是导出其 vtable 指针布局 + 所有非内联虚函数地址。一旦 DLL 和 EXE 使用不同编译器（如 MSVC 2019 vs 2022）、不同运行时（/MD vs /MT）、甚至不同 STL 版本，vtable 偏移或内存布局就可能错位，导致调用虚函数时跳转到错误地址，崩溃无提示。
实操建议：
- 禁止跨 DLL 边界传递标准容器（
std::vector、std::string）作为参数或返回值 - 类中所有虚函数必须声明为
public且**不可内联**（否则 DLL 中无符号，EXE 调用时链接失败） - 若必须导出类，强制 DLL 和调用方使用完全一致的编译选项：
/MD、相同语言标准（/std:c++17）、禁用/GL（全程序优化） - 更稳妥做法：只导出 C 风格纯虚接口（抽象基类），由 DLL 内部 new 实例，通过工厂函数返回指针
extern "C" 导出函数仍出现 GetProcAddress 找不到符号
加了 extern "C" 只解决 C++ 名字修饰（name mangling）问题，但 Windows DLL 默认只导出带有 __declspec(dllexport) 的符号；如果仅靠模块定义文件（.def）导出，又容易漏掉 C++ 编译器生成的修饰名（比如 @func@4）。
实操建议：
- 坚持用
__declspec(dllexport)+extern "C"组合，例如：extern "C" { __declspec(dllexport) int my_c_func(int x); } - 用
dumpbin /exports mylib.dll确认符号是否真出现在导出表里——注意看输出中的“ordinal”和“name”列，不要只扫一眼函数名 - 若用 .def 文件，必须写原始修饰名（可用
dumpbin /symbols查看 OBJ 中的符号），且不能省略EXPORTS关键字 - 32 位与 64 位 DLL 符号名无差异，但调用方进程位数必须严格匹配，否则
LoadLibrary成功但GetProcAddress返回 NULL
静态库（.lib）和导入库（.lib）混淆引发的链接静默失败
VS 生成 DLL 时默认同时输出 mylib.dll 和 mylib.lib（导入库）。这个 .lib 不是静态库，只是符号导入桩；若误将它当作静态库链接进另一个 DLL，会导致最终 EXE 加载时因找不到真实 DLL 而报 0xc0000139（入口点未找到）。
实操建议：
- 区分两种 .lib：静态库（含全部代码，后缀可任意）vs 导入库（仅含符号重定向，必须与同名 DLL 配对）
- 在调用方工程中，“附加依赖项”填
mylib.lib，同时确保运行时能通过 PATH 或同目录找到mylib.dll - 用
link /dump /imports myapp.exe检查是否真引用了目标 DLL，而不是把符号解析到了静态库版本 - 大型项目建议用 CMake 的
add_library(... SHARED)+target_link_libraries，避免手动配 .lib 路径出错
最易被忽略的一点：DLL 工程里改了类成员函数签名，但没更新头文件中的导出宏定义，或者忘了重新生成导入库——此时旧的 .lib 仍存在，链接通过，运行时才崩溃，且堆栈无法回溯到原始源码行。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
