DLL符号导出冲突的根本原因不是命名重复，而是导出控制失效：__declspec(dllexport) 必须仅在DLL编译时生效且严格隔离，否则导致LNK2005重定义或运行时静默覆盖；namespace和static对导出表无效，真正有效的是编译期可见性控制（如-fvisibility=hidden或条件宏）、导出命名唯一化（如前缀或.def文件）及加载策略协同。
直接说结论：DLL 符号导出冲突不是命名重复的问题，而是导出控制没做对——__declspec(dllexport) 必须只在 DLL 编译时生效，且不能被调用方误用；否则轻则 LNK2005 重定义，重则运行时静默覆盖、虚函数跳转崩溃。
为什么加了 __declspec(dllexport) 还是找不到符号？
根本原因不是语法写错，而是导出时机和作用域失控：
- 头文件被 EXE 工程直接包含，导致
__declspec(dllexport)在调用方编译时也展开，链接器报LNK2005: symbol already defined - 类成员函数只在头文件声明处加了
__declspec(dllexport)，但实现写在.cpp里且没同步标注（MSVC 要求显式导出所有虚函数、构造/析构） - 模板函数或类直接加
__declspec(dllexport)无效——它不生成代码，必须显式实例化后导出，例如：template class MYLIB_API std::vector<int>;</int> - 没用
extern "C"包裹 C 风格接口，结果导出的是?init@@YAXXZ这类修饰名，GetProcAddress查不到"init"
如何用宏安全隔离 dllexport 和 dllimport？
靠人工切换必然出错，必须用预处理器强制区分编译角色：
- 在 DLL 工程的「预处理器定义」中添加
BUILDING_MYLIB（名称可自定，但要唯一） - 头文件中统一用条件宏定义接口宏：
#ifdef BUILDING_MYLIB #define MYLIB_API __declspec(dllexport) #else #define MYLIB_API __declspec(dllimport) #endif
- 所有对外接口（函数、类、全局变量）都必须前置该宏，包括类定义：
class MYLIB_API MyClass { ... }; - 即使 DLL 内部调用自己导出的函数，也建议统一用
MYLIB_API标注——避免内联优化后链接异常
为什么 namespace 和 static 不能解决导出冲突？
这是最常被误解的一点：命名空间和静态存储期对 DLL 导出表完全无效。
立即学习“C++免费学习笔记（深入）”；
-
namespace MyLib { void init(); }导出的仍是init（若用了extern "C"）或?init@MyLib@@YAXXZ（若没禁用 mangling），不是MyLib::init -
static void helper()或namespace { void internal() {} }只限制翻译单元可见性，不影响__declspec(dllexport)的导出行为——只要被标记，就进导出表 - 真正起效的是：显式不标记（默认不导出）、用
__attribute__((visibility("hidden")))（Linux/macOS）或/EXPORT链接器参数（Windows）反向隐藏 - 内部辅助函数必须彻底避开导出宏，且最好放在
detail命名空间或.cpp文件内定义
跨平台项目怎么统一管理符号可见性？
不能指望一个属性通吃 Windows/Linux，必须用宏桥接，且注意生效位置：
- Linux/macOS 下 GCC/Clang 默认开启
-fvisibility=hidden，所有符号默认不导出；Windows 下 MSVC 完全忽略__attribute__((visibility)) - 跨平台宏应这样写：
#ifdef _WIN32 #define EXPORT __declspec(dllexport) #else #define EXPORT __attribute__((visibility("default"))) #endif - 关键陷阱：
EXPORT必须加在头文件中的**声明处**（如class EXPORT MyClass;），而不是仅加在.cpp实现里——否则头文件使用者看到的是 hidden 声明，链接失败 - 若头文件被多个模块共享，需配合
#ifdef BUILDING_MYLIB控制宏展开，否则其他模块包含该头文件会意外导出符号 - C++ 模板无法直接用
EXPORT标记，导出类模板需显式实例化；纯 C 接口推荐用extern "C"+ 唯一前缀（如acme_init()），再配EXPORT
最易被忽略的点：导出类时，dynamic_cast 和 RTTI 跨 DLL 生效的前提是整个类（含虚表、type_info）都被导出；而构造/析构函数若未显式标注，EXE 中 new 出的对象可能在 DLL 外析构，引发 CRT 崩溃。这不是配置问题，是 ABI 层面的硬约束。
