C++多模块工程中符号重名冲突需通过五种策略解决：一、启用-fvisibility=hidden并用导出宏控制可见性；二、为extern "C"接口加唯一前缀；三、用匿名命名空间限制单元内符号；四、Linux用version script精确导出；五、Windows用.def文件显式导出。
如果您在C++多模块工程中遇到多个DLL或动态库因同名函数、类或变量引发链接失败或运行时崩溃，则很可能是符号重名冲突所致。namespace本身不控制动态链接期的符号可见性，仅靠包裹代码于不同命名空间无法阻止导出符号撞车。以下是针对该问题的多种隔离与控制策略：
一、启用编译器符号可见性控制
默认情况下，GCC/Clang会导出所有非static的全局符号，这是冲突的根源。必须显式关闭默认导出行为，并仅对真正需跨模块调用的接口开放可见性。
1、在项目编译选项中统一添加 -fvisibility=hidden 参数。
2、定义导出宏，在头文件中封装 visibility 属性：
立即学习“C++免费学习笔记（深入）”；
3、对每个对外暴露的函数或类显式标注宏，例如：MYLIB_API void mylib_init();
4、确保所有内部辅助函数、工具类及未加宏标记的 namespace 成员均被自动隐藏，不进入动态符号表。
二、为 extern "C" 接口强制添加唯一前缀
当使用 extern "C" 导出C风格接口时，namespace 完全失效，name mangling 被禁用，符号名退化为纯标识符。此时若两个模块均导出 int init();，必然发生硬冲突。
1、禁止在 extern "C" 块内嵌套 namespace 以图“语义隔离”。
2、为所有 C 接口函数命名时直接采用 模块名_功能名 格式，例如：acme_v2_config_load()、acme_v2_log_write()。
3、在定义处与头文件声明中保持前缀一致，不得依赖宏替换实现兼容（如 #define init acme_v2_init），否则仍污染全局符号空间。
三、使用匿名命名空间限制翻译单元内符号作用域
对于仅在单个 .cpp 文件中使用的辅助函数、静态工具类或临时变量，应将其置于匿名命名空间中，使其绑定至当前编译单元，彻底避免参与链接解析。
1、在源文件顶部声明：namespace { void internal_helper(); }
2、确保该函数体定义位于同一匿名命名空间内，不带任何导出属性。
3、验证目标文件中该符号类型为 LOCAL：执行 nm -C file.o | grep internal_helper，输出中应含 L 或 l 标识而非 T 或 D。
四、Linux 下使用 version script 精确约束导出符号集
version script 是 GNU ld 提供的机制，可在链接阶段强制限定哪些符号可被外部引用，其余全部隐藏，比 visibility 属性更细粒度且不可绕过。
1、新建 libmylib.map 文件，内容如下：
2、在链接命令中加入参数：-Wl,--version-script=libmylib.map
3、确认导出表仅含指定前缀符号：objdump -T libmylib.so | grep 'mylib_'
五、Windows 下采用模块定义文件（.def）显式导出
在 MSVC 或 MinGW 环境中，避免依赖 __declspec(dllexport) 的隐式行为，改用 .def 文件列出确切需导出的符号，杜绝头文件宏污染导致的意外导出。
1、创建 mylib.def，内容包括 LIBRARY 和 EXPORTS 段：
2、编译时通过 /DEF:mylib.def 传入链接器。
3、使用 dumpbin /exports mylib.dll 验证输出列表是否严格匹配 .def 中所列，无额外符号混入。
