多模块DLL同名符号冲突的根源是全局符号空间污染，解决需五步：一、用-fvisibility=hidden和导出宏控制可见性；二、C导出函数加唯一前缀；三、用.def文件精确导出；四、第三方库用dlopen(RTLD_LOCAL)隔离；五、Linux下用version script精细化管理符号。
如果您在开发多模块DLL工程时遇到不同DLL导出同名函数或变量导致运行时调用错乱、GetProcAddress失败或加载崩溃，则问题根源在于多个DLL将相同符号名暴露至同一进程的全局符号空间。以下是解决此问题的步骤：
一、启用编译期符号可见性控制
默认情况下，GCC/Clang 会导出所有非 static 的全局符号，MSVC 在使用 __declspec(dllexport) 时也默认导出修饰后名称，这极易引发跨DLL符号覆盖。必须通过编译选项强制缩小导出范围，使命名空间组织结构真正落地为链接层隔离。
1、在 GCC/Clang 编译命令中添加 -fvisibility=hidden 参数，确保所有符号默认不可见。
2、在头文件中定义统一导出宏：#define MYDLL_API __attribute__((visibility("default")))（Linux/macOS）或 #define MYDLL_API __declspec(dllexport)（Windows）。
立即学习“C++免费学习笔记（深入）”；
3、仅对明确需跨DLL调用的接口添加该宏，例如：MYDLL_API int mydll_initialize();；所有内部辅助函数、工具类、模板实现均不加宏，自然被隐藏。
二、为C风格导出函数添加唯一前缀
extern "C" 会彻底禁用 C++ 名字修饰，导致 namespace 完全失效；若两个 DLL 均导出 extern "C" { void init(); }，则符号表中均为裸名 init，必然冲突。唯一可靠方式是将命名空间语义“编码进符号名”，通过人工前缀实现硬隔离。
1、确定具有项目/组织唯一性的前缀，例如 acme_core_ 或 widget_v3_，避免使用通用缩写如 lib_、util_。
2、在 extern "C" 块中声明导出函数时，全部使用带前缀的名称：extern "C" { MYDLL_API int acme_core_init(); }。
3、函数定义仍可保留在命名空间内，仅导出层做前缀封装：int acme_core_init() { return MyLib::Core::init(); }。
三、使用模块定义文件（.def）精确控制导出列表
当工程存在大量遗留代码、无法逐个添加导出标记，或需隐藏某些已声明为 __declspec(dllexport) 的符号时，.def 文件提供最底层、最确定的导出控制能力，完全绕过源码级修饰逻辑，直接约束链接器行为。
1、新建文本文件 mydll.def，内容格式如下：
LIBRARY mydll.dll
EXPORTS
acme_core_init @1
acme_core_process_data @2
2、编译时显式指定该文件：link /DLL /DEF:mydll.def mydll.obj（Windows MSVC）。
3、确保 .def 中未列出的任何符号（包括命名空间内函数）均不会出现在导出表中，即使源码中误加了 __declspec(dllexport)。
四、采用 dlopen(RTLD_LOCAL) 隔离第三方符号污染
当必须集成第三方 DLL（其导出裸名 C 函数且无法修改源码），而自身模块也提供同名接口时，不能依赖命名空间或前缀单方面规避——因第三方符号已进入全局符号空间。此时应放弃共享符号解析，改用局部加载机制切断符号泄漏路径。
1、在 Linux 下加载第三方库时，传入 RTLD_LOCAL 标志：void* handle = dlopen("thirdparty.so", RTLD_LOCAL | RTLD_NOW);。
2、所有对该库的函数调用必须通过 dlsym(handle, "func_name") 显式获取地址，禁止使用 dlsym(RTLD_DEFAULT, "func_name")。
3、自身模块导出的同名函数（如 mydll_init）保持前缀并启用 visibility=hidden，确保其符号与第三方完全独立。
五、使用 version script（.map）限制 Linux 共享库符号可见性
GNU ld 的 version script 是 Linux 平台下比 visibility 属性更精细的符号控制手段，可按通配符分组导出、隐藏内部符号，并支持版本化符号管理，适用于需长期维护 ABI 兼容性的多模块工程。
1、创建 mydll.map 文件，内容如下：
MYDLL_1.0 {
global:
acme_core_*;
local:
*
2、编译时通过 -Wl,--version-script=mydll.map 传递给链接器。
3、验证导出结果：readelf -Ws libmydll.so | grep GLOBAL | grep FUNC，确认仅含预期前缀符号。
