仅靠 namespace 无法解决 DLL 符号导出冲突，真正起效的是编译期可见性控制（如 -fvisibility=hidden 或 __declspec(dllexport) 精确标注）、导出命名唯一化（如模块前缀或 .def 文件别名）和加载策略协同（如 RTLD_LOCAL 或 LOAD_LIBRARY_AS_DATAFILE）。
直接说结论：仅靠 namespace 无法解决 DLL 符号导出冲突，真正起效的是编译期可见性控制 + 导出命名唯一化 + 加载策略协同。运行时崩溃、GetProcAddress 返回 NULL、链接报 LNK2005，八成是这三个环节中某一个没卡死。
__declspec(dllexport) 必须配合宏开关，否则会炸链
常见错误是把同一份头文件扔进 DLL 工程和调用方 EXE 工程，且都定义了 MYLIB_API __declspec(dllexport)。结果 DLL 工程正常导出，EXE 工程却试图“再导出一遍”，链接时报 LNK2005: symbol already defined。
- DLL 工程预处理器中必须定义
BUILDING_MYLIB（或类似标识） - 头文件中写条件宏：
#ifdef BUILDING_MYLIB→#define MYLIB_API __declspec(dllexport)；否则 →#define MYLIB_API __declspec(dllimport) - 调用方工程绝对不能定义
BUILDING_MYLIB，否则它会把自己当成 DLL 去导出符号 - 类、模板函数、全局变量都不能直接套这个宏——类需显式导出虚函数，模板需显式实例化，变量需加
__declspec(selectany)
extern "C" + namespace 是危险组合，前缀才是硬隔离
写成 extern "C" { namespace MyLib { void init(); } } 看似优雅，实则失效：name mangling 被禁用，namespace 信息被丢弃，最终导出纯符号 init。若另一个 DLL 也导出 init，加载顺序决定谁胜出，静默覆盖。
- 所有
extern "C"导出函数必须带唯一前缀，如acme_v2_init()、widget_core_process() - 前缀要真实出现在声明、定义、调用三方代码中，禁止用
#define init acme_v2_init做兼容——这仍向符号表注入acme_v2_init，未解决本质问题 - 函数体内可保留命名空间逻辑：
int acme_v2_init() { return MyLib::Core::init(); } - 检查导出表是否真含前缀：
dumpbin /exports mylib.dll | findstr "acme_v2"（Windows）或nm -D libmylib.so | grep acme_v2（Linux）
.def 文件是 Windows 下最底层、最确定的导出控制方式
当遗留代码太多、没法逐个加 __declspec，或需要隐藏某些已声明为导出的符号时，.def 文件绕过源码修饰，直接由链接器按字面匹配，不依赖 name mangling 规则。
-
.def文件必须包含LIBRARY和EXPORTS段，例如：LIBRARY mylib.dll+EXPORTS acme_v2_init @1 - 若需别名映射（比如把
MyNamespace::init@0导出为acme_v2_init），写成：acme_v2_init = ?init@MyNamespace@@YAXXZ @1（符号名需用dumpbin /symbols查准） - VS 项目中配置路径：属性 → 链接器 → 输入 → 模块定义文件 → 填
mylib.def - 注意：.def 不处理 C++ 重载，也不支持模板，只适合稳定 ABI 的 C 接口层
Linux/macOS 下必须配 -fvisibility=hidden，否则默认全导出
GCC/Clang 默认导出所有非 static 全局符号，哪怕你在 namespace 里写了十层嵌套，照样进动态符号表。不加控制，大型项目一上多模块就撞车。
- 编译时统一加
-fvisibility=hidden，让所有符号默认不可见 - 头文件中定义宏：
#define MYLIB_API __attribute__((visibility("default"))) - 仅对真正对外接口加该宏，如：
MYLIB_API void mylib_init();；其余内部函数、工具类、模板实现一律不加 - 搭配版本脚本（
.map）可进一步收紧：LIBNET_1.0 { global: libnet_*; local: *; };，链接时加-Wl,--version-script=libnet.map
最容易被忽略的点是：符号可见性控制必须贯穿编译、链接、加载三阶段。漏掉任意一环——比如编译开了 -fvisibility=hidden 却忘了在头文件里加 __attribute__((visibility("default")))，或者用了 RTLD_LOCAL 却没关掉其他库的全局符号污染——冲突依然会发生，且表现随机、复现困难。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
