CMake+C++项目同时用pugixml与OpenXLSX出现链接错误求解决

问题根源 #

Windows的MSVC链接器对重复符号的检查远严格于Linux的ld链接器：当OpenXLSX内部编译了一份pugixml，同时你的项目又链接了独立引入的pugixml静态库时，就会触发LNK2005重复定义错误。Linux下链接器默认会忽略重复符号（取第一个遇到的实例），因此无报错。

优雅解决方案 #

方案一：强制OpenXLSX复用项目中的pugixml

OpenXLSX的CMake配置提供了OPENXLSX_USE_SYSTEM_PUGIXML选项，开启后会直接使用项目中已引入的pugixml，而非编译自带的副本。修改根目录CMakeLists.txt：

include(cmake/CPM.cmake)
# 先引入pugixml，确保OpenXLSX能检测到它
CPMAddPackage("gh:zeux/pugixml@1.14")
# 引入OpenXLSX时启用系统pugixml选项
CPMAddPackage(
  "gh:troldal/OpenXLSX#ededa1e8398305d0983648d3e9f120ff7e228d2b"
  OPTIONS
    "OPENXLSX_USE_SYSTEM_PUGIXML ON"
)

此方案从根源避免了重复编译pugixml，是最优解。

方案二：将pugixml编译为动态库

若OpenXLSX无法适配外部pugixml，可将pugixml编译为动态库（DLL），使符号仅存在于单一动态库实例中，消除静态库的符号冲突：

CPMAddPackage(
  "gh:zeux/pugixml@1.14"
  OPTIONS
    "BUILD_SHARED_LIBS ON"
)

需确保OpenXLSX也链接到该动态库版本，避免运行时依赖不一致。

方案三：调整链接顺序（临时 workaround）

MSVC链接器会优先使用后遇到的库中的符号，临时调整链接顺序可绕过错误：

target_link_libraries(io PUBLIC spdlog::spdlog Eigen3::Eigen OpenXLSX::OpenXLSX pugixml)

⚠️ 此方案仅掩盖问题，两个pugixml副本仍会存在，可能引发运行时未定义行为，不推荐长期使用。

内容的提问来源于stack exchange，提问作者skrat