根本原因是头文件被不同项目以不同宏定义包含，导致__declspec(dllexport)误转为__declspec(dllimport)且未链接对应.lib，引发lnk2019；实操须统一宏控制、正确配置预处理器定义与.lib路径，并用dumpbin验证真实导出符号。
为什么 __declspec(dllexport) 在跨项目时经常失效
根本原因不是语法写错，而是头文件被不同项目以不同宏定义包含——比如 A 项目定义了 MYLIB_EXPORTS，B 项目没定义，结果同一份头文件里 __declspec(dllexport) 变成 __declspec(dllimport)，而 B 项目又没链接对应 .lib，最终报 LNK2019: unresolved external symbol。
实操建议：
- 导出头文件必须用统一、稳定的宏控制，例如：
#ifdef MYLIB_EXPORTS<br> #define MYLIB_API __declspec(dllexport)<br>#else<br> #define MYLIB_API __declspec(dllimport)<br>#endif
- 确保每个使用该 DLL 的项目，在「属性 → C/C++ → 预处理器 → 预处理器定义」中都**不定义**
MYLIB_EXPORTS（仅编译 DLL 项目时才定义） - 检查生成的 .lib 是否被正确添加到调用项目的「链接器 → 输入 → 附加依赖项」，路径也要在「链接器 → 常规 → 附加库目录」中配置
C++ 类成员函数导出时为何只看到构造函数/析构函数符号，其他全丢
因为类默认不导出，即使加了 MYLIB_API，编译器仍可能内联或优化掉非虚函数；更常见的是：你只给类加了修饰，但忘了对模板成员、静态成员、友元函数单独处理。
实操建议：
- 所有需导出的成员函数（包括构造/析构/赋值运算符）都必须显式标注
MYLIB_API，不能只标在类名上（除非用class MYLIB_API MyClass { ... };这种方式，但仍有局限） - 模板类/函数无法直接导出到 DLL——要么显式实例化（
template class MYLIB_API std::vector<myclass>;</myclass>），要么改用头文件内联实现 - 静态成员变量必须额外加
MYLIB_API（类内声明不算定义），否则链接时报LNK2001
同一个 DLL 在多个 EXE 中加载后，全局变量/单例状态互相污染
这不是符号可见性问题，而是 Windows 默认启用“DLL 共享节”+ 进程内单实例机制导致的——每个进程加载一份 DLL，但若用了 __declspec(allocate(...)) 或自定义数据段，且未设为可写/可共享，就可能误共享内存。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
实操建议：
- 避免在 DLL 中放非 const 全局变量；如必须，用线程局部存储（
thread_local）或按需传参替代 - 确认没有误用
#pragma data_seg("SHARED")+#pragma comment(linker, "/SECTION:SHARED,RWS")，这种写法极易引发多进程间状态串扰 - 单例模式务必检查构造时机：DLL_PROCESS_ATTACH 时初始化是安全的，但若依赖其他尚未加载的 DLL，会静默失败
如何验证 DLL 真正导出了哪些符号
靠 IDE 提示或头文件声明完全不可靠。必须用工具看真实 PE 导出表——尤其要注意 C++ 名称修饰（mangled name）是否和链接时请求的一致。
实操建议：
- 用
dumpbin /exports mylib.dll（VS 自带）查看原始导出列表，注意对比函数名是否带修饰（如??0MyClass@@QEAA@XZ） - 若需干净的 C 风格符号（无修饰），函数必须用
extern "C"包裹，且声明为MYLIB_API void my_func();（不能是类内函数） - 用
Dependency Walker或Dependencies.exe（现代替代）打开 EXE，直接看它尝试导入的符号是否在 DLL 导出列表中匹配
最易被忽略的点：C++ 导出符号的 ABI 兼容性完全依赖编译器版本、运行时库（MT/MD）、甚至结构体填充方式。两个用不同 VS 版本或不同 /std:c++17 设置编译的 DLL/EXE，哪怕符号名完全一致，也可能因 vtable 偏移或异常处理机制差异导致崩溃——这不是可见性问题，但常被误判为导出失败。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
