解决C++ DLL符号导出问题需五步：一、用__declspec(dllexport/dllimport)显式标注；二、统一运行时库（/MD或/MDd）；三、用.def文件精细控制导出；四、跨平台用visibility属性；五、模板须显式实例化导出。
当在大型跨工程项目中使用 C++ 编写动态链接库（DLL）时，若符号导出未显式声明或可见性控制策略不一致，将导致链接失败、运行时崩溃或符号重复定义等不可预测行为。以下是解决此问题的步骤：
一、使用 __declspec(dllexport) / __declspec(dllimport) 显式标注符号
Windows 平台下，DLL 符号默认不可见，必须通过编译器指令明确导出或导入。未加修饰的类、函数、全局变量在 DLL 外部不可见，即使头文件被包含也无法链接成功。
1、在 DLL 工程中定义宏，如 MYLIB_EXPORTS，并在预处理器设置中启用该宏。
2、在公共头文件中定义导出宏：#define MYLIB_API __declspec(dllexport)（当 MYLIB_EXPORTS 定义时），否则定义为 #define MYLIB_API __declspec(dllimport)。
3、对需暴露的函数、类声明前添加 MYLIB_API，例如：extern "C" MYLIB_API int compute_value(int x);
4、对类导出需注意：整个类必须用 MYLIB_API 标注，且所有虚函数表相关成员（含析构函数）均受导出控制影响。
二、启用 Windows Runtime Library 的 /MD 或 /MDd 一致性配置
DLL 与调用方若使用不同运行时库（如一个用 /MT，另一个用 /MD），会导致堆管理分离、new/delete 不匹配、静态变量重复实例化等问题，间接引发符号解析异常或内存错误。
1、在 DLL 工程属性中，进入“C/C++ → 代码生成 → 运行时库”，选择 /MD（Release）或 /MDd（Debug）。
2、在所有依赖该项目的可执行工程及子模块中，同步设置相同的运行时库选项。
3、检查项目间是否混用 STL 容器作为 DLL 接口参数；若必须传递，确保两端编译器版本、ABI 及运行时库完全一致。
三、采用 .def 文件控制符号导出粒度
当头文件无法统一修改，或需隐藏实现细节、仅导出特定 C 风格函数时，.def 文件提供更底层、更可控的导出机制，绕过头文件宏污染和模板导出限制。
1、新建文本文件，命名为 MyLib.def，保存于 DLL 工程目录下。
2、在文件中声明 EXPORTS 段，逐行列出需导出的函数名（不带修饰），例如：EXPORTS compute_value get_version_string。
3、在 DLL 工程属性中，“链接器 → 输入 → 模块定义文件”填入 MyLib.def 路径。
4、编译后使用 dumpbin /exports MyLib.dll 验证导出符号列表是否符合预期。
四、启用 __attribute__((visibility("default"))) 与 -fvisibility=hidden（跨平台兼容路径）
对于同时构建 Windows DLL 与 Linux SO 的项目，使用 GCC/Clang 编译器时，可通过 visibility 属性统一控制符号可见性，避免 Windows 下遗漏 dllexport 导致的隐藏符号问题。
1、在跨平台头文件中定义宏：#if defined(__GNUC__) || defined(__clang__) #define EXPORT_API __attribute__((visibility("default"))) #else #define EXPORT_API __declspec(dllexport) #endif
2、在项目 CMakeLists.txt 中添加编译选项：set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fvisibility=hidden")。
3、确保所有对外接口均显式使用 EXPORT_API，未标注者默认隐藏，杜绝意外导出内部符号。
4、验证 Linux 构建产物：使用 readelf -Ws libmylib.so | grep DEFAULT | grep GLOBAL 查看仅导出标记符号。
五、禁用模板隐式实例化导出，改用显式实例化声明
模板函数或类成员函数若在 DLL 中定义且未显式实例化，其符号不会进入导出表；调用方尝试实例化时会生成本地副本，造成 ODR 违规、状态不一致或链接失败。
1、在 DLL 源文件（非头文件）中，对需导出的模板特化进行显式实例化声明，例如：template class MYLIB_API std::vector
2、若导出模板函数，使用 template MYLIB_API MyResult process_data
3、禁止在头文件中同时定义和导出模板（即“头文件内联实现 + dllexport”组合），该模式在 MSVC 下不被支持且行为未定义。
4、对泛型接口，优先考虑基于抽象基类的 PIMPL 或工厂函数封装，规避模板导出问题。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
