__declspec(dllexport) 不能直接作用于命名空间内函数，因C++标准不支持导出命名空间，该修饰符仅适用于可链接实体（如全局函数、类、变量等），作用于命名空间时会被编译器静默忽略，导致LNK2019链接错误且dumpbin查无此导出符号。
为什么 __declspec(dllexport) 不能直接作用于命名空间内的函数
因为 C++ 标准不支持对命名空间本身做导出修饰，__declspec(dllexport) 只能修饰「可链接实体」：全局函数、类、变量、模板显式实例化——但不包括命名空间。如果你写了 namespace ns { __declspec(dllexport) void f(); }，编译器会静默忽略 __declspec(dllexport)，导致调用方链接时出现 LNK2019: unresolved external symbol。
常见错误现象是：头文件里声明了函数，DLL 编译通过，但 EXE 调用时找不到符号；用 dumpbin /exports 查看 DLL 导出表，发现该函数根本没出现。
- 必须把
__declspec(dllexport)显式加在每个要导出的函数/类声明前（不是定义处） - 头文件中需用宏控制：Windows 下展开为
__declspec(dllexport)，其他平台为空或__attribute__((visibility("default"))) - 类的所有虚函数自动继承导出属性，但非虚成员函数仍需逐个标注（除非整个类已导出）
如何避免 C++ 类成员函数因 ABI 不兼容导致的 DLL 调用崩溃
跨工程 DLL 中，只要类定义稍有变动（比如增删私有成员、调整基类顺序、修改虚函数表位置），即使接口签名完全一致，也可能引发运行时崩溃——因为调用方按旧内存布局读写对象，而 DLL 返回的是新布局实例。
根本原因是：C++ 类的二进制布局（sizeof、成员偏移、vtable 排列）不是 ABI 稳定的，且不同编译器/标准库版本间差异极大。
立即学习“C++免费学习笔记（深入）”；
- 禁止直接导出非 POD 类型（尤其是含
std::string、std::vector成员的类）给外部工程使用 - 导出纯 C 风格接口：用
extern "C"+__declspec(dllexport)函数，参数/返回值仅限基本类型、指针、固定大小结构体 - 若必须导出类，采用 PIMPL 惯用法：头文件只声明不含实现细节的外壳类，所有数据和虚函数逻辑封装在 DLL 内部的不透明指针后
- 确保 DLL 和调用方使用完全相同的 CRT（/MD 或 /MT）和 STL 版本；混用 /MDd 和 /MD 会导致堆分配不匹配
为什么 __declspec(dllimport) 在调用方不加也常能链接成功，但不推荐省略
链接器在找不到 dllimport 修饰时，会退化为“延迟加载”或“隐式导入”，生成跳转桩（thunk），性能略低；更严重的是：若函数内联展开（如头文件中定义为 inline），而调用方未声明 dllimport，编译器可能错误地将其当作本地函数内联，导致运行时调用到未初始化的地址。
典型症状是：Debug 下正常，Release 下崩溃；或者首次调用返回垃圾值，后续调用才正常——本质是内联与导入语义冲突。
- 必须在调用方头文件中，用同一套宏控制
__declspec(dllimport)（例如#define MYAPI __declspec(dllimport)） - 宏定义需与 DLL 工程严格对称：DLL 编译时定义
MYLIB_EXPORTS，展开为dllexport；调用方不定义，展开为dllimport - 对于模板函数，不要导出其实例化体，而是将模板声明和定义全放在头文件中，并禁用隐式实例化（
extern template需谨慎）
怎样让 DLL 中的 C++ 符号名不被 C++ Name Mangling 破坏，便于手动 GetProcAddress
默认情况下，__declspec(dllexport) 导出的 C++ 函数名经过编译器修饰（mangling），形如 ?func@ns@@YAXXZ，无法用字符串字面量直接传给 GetProcAddress。虽然可用 dumpbin /exports 查看真实符号名，但极其脆弱——任何重命名、重载、参数类型微调都会改变修饰名。
真正可靠的方式是：用模块定义文件（.def）显式指定导出符号的原始名称，或强制用 extern "C" 抑制 mangling。
- 在 .def 文件中写：
EXPORTS func @1 NONAME，然后链接时加上/DEF:mylib.def；注意@1是序号，NONAME表示不存名字（只能靠序号调用） - 更实用的是结合
extern "C"：extern "C" __declspec(dllexport) int my_api(int x);，这样导出名为my_api，可直接GetProcAddress(h, "my_api") - 若必须保留 C++ 语义（如重载、类方法），改用 COM 接口或工厂函数返回抽象基类指针，彻底绕过符号名问题
最易被忽略的一点：DLL 的导出控制不是「写一次就完事」，它深度耦合于头文件分发策略、构建系统配置（CMake 的 WINDOWS_EXPORT_ALL_SYMBOLS 默认关闭）、以及是否启用增量链接（/INCREMENTAL）。哪怕只改了一个 static 修饰符，都可能让原本导出的符号消失——务必每次构建后用 dumpbin /exports 实际验证。
