C++多模块工程中同名符号冲突的解决方案包括：一、启用编译器可见性控制（如-fvisibility=hidden）并显式标记导出符号；二、为C接口添加唯一前缀；三、用匿名命名空间限制内部符号作用域；四、以dlopen+RTLD_LOCAL显式加载隔离；五、用链接器版本脚本精确控制导出。
如果您在C++多模块工程中遇到多个DLL或共享库导出同名符号导致链接失败、运行时崩溃或ODR违规，则问题根源在于符号未被有效隔离。以下是解决此问题的步骤：
一、启用编译器符号可见性控制
namespace本身仅影响编译期名称查找，不改变链接器看到的导出符号；真正起效的是强制隐藏非接口符号，从源头减少冲突面。必须配合编译器可见性属性使用，否则所有非static全局符号默认导出，namespace形同虚设。
1、GCC/Clang项目中，在编译命令行添加 -fvisibility=hidden 选项。
2、在头文件中定义导出宏，区分构建与使用场景：
立即学习“C++免费学习笔记（深入）”；
3、对真正需跨模块调用的函数或类显式标记 __attribute__((visibility("default")))，例如：MYLIB_API void libA_init();
4、确保所有内部辅助函数、工具类、模板特化体均不加导出标记，使其自动受 hidden 约束。
二、为C风格导出函数添加唯一前缀
当使用 extern "C" 导出接口时，namespace完全失效，name mangling被禁用，符号退化为纯名称；此时唯一可靠方案是人工引入不可冲突的命名前缀，使符号在动态链接层面天然隔离。
1、将原函数 void init(); 重命名为 liba_init();
2、在头文件中统一使用带组织标识的前缀，如 acme_v2_config_load();，避免使用易重复的缩写（如 ml_、core_）。
3、所有调用方代码必须直接使用新前缀名，禁止通过 #define init liba_init 进行宏替换——该方式污染调用侧命名空间且无法防止符号表污染。
4、检查第三方C接口是否提供类似 PNG_EXPORT 的导出封装机制，优先复用其命名约定。
三、使用匿名命名空间限制翻译单元内符号作用域
对于仅在单个源文件内使用的辅助函数或静态数据，匿名命名空间可确保其符号不进入目标文件的全局符号表，彻底规避跨模块可见性，比 static 更符合C++惯用法且支持类型安全。
1、在 .cpp 文件顶部声明：namespace { void internal_helper(); }
2、将所有非导出的工具函数、私有回调、临时对象构造逻辑移入该匿名命名空间。
3、确认该文件编译生成的目标文件中不再包含对应符号：执行 nm -C your_file.o | grep internal_helper，应无输出或仅显示 U（undefined）或 t（local text）类型。
4、禁止在头文件中定义匿名命名空间内容，否则每个包含该头的编译单元将生成独立副本，违反ODR。
四、采用 dlopen + RTLD_LOCAL 手动加载隔离
当无法修改冲突第三方DLL源码时，隐式链接（即直接链接 .lib/.a 或声明 __declspec(dllimport)）必然触发全局符号解析；改用显式加载并限定作用域，可使各库符号互不可见，绕过链接器冲突判定路径。
1、移除所有对该DLL的隐式链接声明，包括头文件中的 __declspec(dllimport) 和链接器输入项。
2、在运行时调用 LoadLibraryEx(L"libA.dll", nullptr, LOAD_WITH_ALTERED_SEARCH_PATH)（Windows）或 dlopen("libA.so", RTLD_LOCAL | RTLD_LAZY)（Linux）。
3、使用 GetProcAddress 或 dlsym 获取函数地址，例如：auto pfn = (decltype(&libA_init))GetProcAddress(hLib, "libA_init");
4、确保每次加载均使用 RTLD_LOCAL（Linux）或不设 LOAD_LIBRARY_GLOBAL（Windows），防止符号泄露至进程全局符号表。
五、使用链接器版本脚本精确控制导出集合
在Linux/macOS平台，version script（.map文件）提供比 visibility 属性更细粒度的导出控制能力，可显式列出允许外部访问的符号模式，并将其余全部设为 local，适用于需要严格审计API边界的大型SDK。
1、创建 libA.map 文件，内容为：LIBA_1_0 { global: liba_*; local: *; };
2、编译时通过 -Wl,--version-script=libA.map 将其传给链接器。
3、验证导出表是否生效：objdump -T libA.so | grep "liba_" 应仅显示预期前缀函数，且无其他符号。
4、若需兼容多版本ABI，可在同一.map中追加 LIBA_2_0 { global: liba_v2_*; inherit: LIBA_1_0; };
