根本原因是dll导出符号默认进入全局作用域且无命名空间隔离，导致同名函数在链接时冲突；即使使用namespace或内联函数，导出名仍是裸名，引发lnk2005等错误。
为什么DLL导出的函数名会在链接时冲突
根本原因不是C++名字修饰（name mangling）本身，而是导出符号默认进入全局作用域，且DLL不自动隔离命名空间。哪怕你在源码里写了 namespace mylib，用 __declspec(dllexport) 导出的函数，其链接器可见名仍是未加命名空间前缀的裸名（比如 MyFunc），其他DLL或主程序若导出同名函数，链接器就报 LNK2005 或运行时报 Access Violation。
常见诱因包括：
- 多个第三方DLL都导出了
Init、Destroy、GetVersion这类通用名 - 静态链接了同一份头文件（含内联函数/模板），但不同DLL各自编译，导致符号重复定义
- 忘记给C接口加
extern "C"，导致C++修饰名在不同编译器下不一致，间接引发隐式重名
用模块定义文件（.def）强制控制导出符号名
.def 文件是绕过C++修饰、精确控制导出表的最可靠方式，它不依赖编译器行为，也不受命名空间影响。关键在于：导出名由 EXPORTS 节显式指定，与源码中函数名、命名空间完全解耦。
操作步骤：
- 新建
mylib.def，写入：LIBRARY mylib.dll EXPORTS mylib_Init @1 mylib_Destroy @2 mylib_ProcessData @3 - 在项目设置中把
mylib.def加入链接器输入（Visual Studio：属性 → 链接器 → 输入 → 模块定义文件） - 源码中函数可任意命名和封装：
namespace mylib { void InitImpl() { /* ... */ } void DestroyImpl() { /* ... */ } } // 导出函数仅作转发，无修饰、无命名空间污染 extern "C" __declspec(dllexport) void mylib_Init() { mylib::InitImpl(); }
注意：@1 等序号能提升加载性能，但非必需；若省略序号，导出名必须与 EXPORTS 中完全一致（大小写敏感）。
用__declspec(dllexport)配合extern "C"和命名空间别名
如果不想用 .def，又想避免重名，核心是两点：禁用C++修饰 + 人为添加命名空间前缀。直接在函数名上加前缀比依赖C++命名空间更稳妥，因为链接器根本不认 namespace。
推荐写法：
- 头文件中用宏统一管理前缀：
#define MYLIB_API extern "C" __declspec(dllexport) MYLIB_API int mylib_open_device(int id); MYLIB_API void mylib_close_device();
- 禁止在导出声明中使用命名空间作用域（如
mylib::open_device），这在C链接约定下非法 - 实现文件里可自由使用命名空间，但导出函数必须是顶层自由函数：
namespace mylib { int open_impl(int id) { /* ... */ } } extern "C" __declspec(dllexport) int mylib_open_device(int id) { return mylib::open_impl(id); }
警告：不要试图用 using namespace mylib 后再导出，这不会改变链接名，反而可能引入意外的ADL（参数依赖查找）问题。
隐藏非导出符号：/GR- 和 static 不够，得靠 __declspec(dllimport) 和链接器开关
重名冲突不仅来自导出符号，也来自DLL内部未隐藏的全局变量、内联函数、模板实例——它们可能被主程序或其它DLL意外链接到。Visual Studio 默认启用RTTI和异常处理，会暴露大量辅助符号。
真正有效的隐藏手段：
- 编译时加
/GR-（禁用RTTI）和/EHsc-（禁用异常处理），减少辅助符号 - 对所有非导出全局变量/函数加
static或匿名命名空间：namespace { int internal_counter = 0; // 确保仅本编译单元可见 } - 在DLL工程属性中启用“隐藏所有符号”（Visual Studio：属性 → 链接器 → 高级 → 导出符号 → 留空；并勾选“隐藏所有符号”）
- 对导入端（调用DLL的程序），必须用
__declspec(dllimport)声明，否则链接器可能把导入符号当成未定义引用去全局搜，触发误匹配
最容易被忽略的是：即使你没写任何 __declspec(dllexport)，只要启用了“导出所有符号”（默认关闭），链接器仍可能把 public 类成员、全局函数全导出——务必检查该选项是否为禁用状态。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
