namespace本身不能解决dll符号重名冲突，必须配合extern "c"+前缀、visibility=hidden、def文件、匿名命名空间或rtld_local加载等手段实现有效隔离。
如果您在 Windows 平台开发 C++ DLL 时遇到多个库导出同名函数（如 init、process、log）导致加载失败、GetProcAddress 返回 NULL 或运行时调用错乱，则问题根源在于 DLL 导出符号未做有效隔离。namespace 本身不解决该问题，但可作为隔离策略的一环协同生效。以下是多种可落地的 namespace 隔离法：
一、使用 extern "C" + 唯一前缀封装命名空间实现
此方法将命名空间逻辑“平移”至符号名称中，彻底规避 C++ 名字修饰不可控与 extern "C" 裸名冲突双重风险。所有对外导出函数均以库标识前缀命名，并通过 extern "C" 禁用修饰，确保跨编译器、跨语言调用稳定性。
1、在头文件中声明带前缀的 C 兼容接口，例如：extern "C" __declspec(dllexport) int mylib_v2_init();
2、在源文件中定义该函数，并内部调用命名空间内真实实现：return MyLib::v2::Core::initialize();
3、确保所有导出函数均采用统一前缀（如 mylib_v2_），且前缀包含版本或组织信息，避免缩写泛化（如 ml_）。
二、启用 -fvisibility=hidden 并配合 visibility("default") 显式导出
该方法从编译源头抑制符号泄露，使 namespace 内部函数默认不可见于动态链接层。仅对明确需暴露的接口加 visibility("default")，从而让命名空间真正发挥逻辑组织作用，而非依赖其修饰名防冲突。
1、编译 DLL 时添加选项：-fvisibility=hidden（GCC/Clang）或在 MSVC 中设置“隐藏未标记符号”属性。
2、在头文件中定义宏：#define MYLIB_API __attribute__((visibility("default")))
3、仅对需导出的函数或类添加该宏：MYLIB_API void mylib_process_data(const char*);
4、所有未标注 MYLIB_API 的函数（包括 namespace MyLib { void helper(); }）将自动被隐藏，不进入导出表。
三、采用 DEF 文件精确控制导出符号列表
DEF 文件绕过编译器自动导出机制，强制由开发者显式声明每个导出符号名，完全脱离命名空间语义干扰。适用于需严格管控符号可见性、避免宏污染或兼容旧构建系统的场景。
1、创建 mylib.def 文件，内容为：EXPORTS
mylib_v2_init
mylib_v2_process_data
mylib_v2_shutdown
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
2、在链接阶段将该文件传入链接器（MSVC：项目属性 → 链接器 → 输入 → 模块定义文件；MinGW：-Wl,mylib.def）。
3、源码中所有函数均不使用 __declspec(dllexport)，避免头文件宏意外触发全局导出。
四、使用匿名命名空间 + static 限定内部辅助符号
此方法专用于消除 DLL 内部工具函数、回调注册器等非导出实体的符号污染。匿名命名空间与 static 共同确保这些符号不具备外部链接性，从根本上杜绝其出现在导出表中，即使它们与其它库同名也不会引发冲突。
1、在 .cpp 文件顶部声明匿名命名空间：namespace { void internal_config_loader(); }
2、所有仅本文件使用的函数、变量均置于其中，无需额外修饰。
3、对独立函数亦可直接使用 static：static void legacy_compatibility_hook();
4、验证导出表是否已剔除上述符号：dumpbin /exports mylib.dll | findstr internal 应无输出。
五、通过 dlopen(RTLD_LOCAL) 加载约束实现运行时隔离
当无法修改 DLL 源码时，可在宿主程序侧控制加载行为。RTLD_LOCAL 使 DLL 导出符号不加入全局符号表，避免与其他已加载 DLL 的同名符号发生覆盖或解析冲突，实现运行时层级的 namespace 效果。
1、使用 dlopen 打开 DLL 时指定标志：void* handle = dlopen("mylib.dll", RTLD_NOW | RTLD_LOCAL);
2、所有符号解析必须通过 dlsym(handle, "mylib_v2_init") 进行，禁止直接调用裸名函数。
3、同一进程可安全加载多个含同名函数的 DLL，只要各自 handle 分离且未使用 RTLD_GLOBAL。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
