根本原因是多个dll向同一进程全局符号空间导出同名符号且未裁剪可见性；__declspec(dllexport)冲突源于宏未隔离导致lnk2005，或虚函数/模板漏标引发abi崩溃，extern "c"不自动导出需配合dllexport或.def文件。
大型跨模块工程中 DLL 符号冲突不是编译期报错，而是运行时静默覆盖或 GetProcAddress 失败——根本原因在于多个 DLL 向同一进程全局符号空间导出同名符号，且未做可见性裁剪。仅靠 namespace 或头文件隔离完全无效。
为什么 __declspec(dllexport) 加了还是冲突？
常见错误是把同一份头文件直接复用于 DLL 和调用方，没做宏开关隔离：__declspec(dllexport) 必须只在 DLL 编译时生效，若调用方也定义了该宏，就会触发 LNK2005 重复定义；更隐蔽的是，类中虚函数、静态成员、模板显式实例化点若漏标，可能导出未预期的符号（如 vtable 或 RTTI），导致 ABI 不兼容崩溃。
- DLL 工程预处理器中必须定义唯一宏（如
BUILDING_MYLIB），调用方**绝对不定义** - 头文件中用条件宏控制：
#ifdef BUILDING_MYLIB #define MYLIB_API __declspec(dllexport) #else #define MYLIB_API __declspec(dllimport) #endif - 类声明前加
MYLIB_API，但析构函数、虚函数、静态成员函数仍需单独标注——类修饰不自动传递 - 模板类导出必须显式实例化并标注：
template class MYLIB_API MyTemplate<int>;</int>
extern "C" 导出后 GetProcAddress 找不到符号？
extern "C" 只禁用 name mangling，但 Windows 下它**不自动导出**——仍需 __declspec(dllexport) 或 .def 文件配合，否则符号根本不在导出表里。用 dumpbin /exports mylib.dll 查看输出，若没出现你写的函数名，说明它没被真正导出。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 坚持组合写法：
extern "C" { __declspec(dllexport) int acme_v2_init(); } - 禁止在
extern "C"块内嵌套namespace，那会彻底丢弃命名空间语义，只剩裸名init - 所有 C 风格导出函数必须带唯一前缀（如
acme_v2_），不能靠#define init acme_v2_init兼容——这仍向符号表注入acme_v2_init，未解决多库共存问题 - 若已有遗留代码无法改名，用
.def文件硬绑定别名：init@1 = MyNamespace::init@0，右边必须是dumpbin /symbols真实看到的修饰名
Linux/macOS 下如何验证 -fvisibility=hidden 是否真生效？
很多人在 CMakeLists.txt 里加了 target_compile_options(... -fvisibility=hidden) 就以为完事，但子目录源文件可能不受影响。C++ 编译器按翻译单元处理可见性，漏一个 .cpp，就可能导出整套虚表和模板实例。
- 根
CMakeLists.txt中设全局预设：set(CMAKE_CXX_VISIBILITY_PRESET hidden)和set(CMAKE_VISIBILITY_INLINES_HIDDEN ON) - 对每个共享库 target 显式设置：
set_target_properties(your_lib PROPERTIES CXX_VISIBILITY_PRESET hidden VISIBILITY_INLINES_HIDDEN ON) - 验证命令：
readelf -s libyour.so | grep "FUNC.*GLOBAL.*DEFAULT"—— 输出应极少，且仅限你手动加了__attribute__((visibility("default")))的接口 - 内联函数若在头文件中定义，必须确保包含该头前已定义 visibility 宏，否则多次包含可能生成多个
LOCAL符号，违反 ODR
最易被忽略的点：虚函数表和 RTTI 默认导出，哪怕类本身没加 __declspec(dllexport)，只要某个成员函数被导出，整个 vtable 可能被拖进导出表；而不同编译器/运行时版本对 vtable 布局解释不同，会导致调用时跳转到非法地址——这不是链接错误，是运行时静默崩溃。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
