Windows下CMake构建Expat出现未解析外部符号错误求助

问题背景 #

C++程序依赖Expat库，在Linux/macOS环境下构建正常，但在GitHub windows-2022运行器上构建时出现大量未解析外部符号错误，错误符号均带有__imp_前缀，目标是将Expat作为静态库使用。

错误原因 #

错误中的__imp_前缀表明编译器将Expat的函数视为动态链接库（DLL）的导入符号，但实际我们链接的是静态库。这是因为Expat的头文件默认会根据是否定义XML_STATIC宏来切换静态/动态链接模式：

• 未定义XML_STATIC时，头文件会生成DLL导入声明，导致编译器生成带__imp_前缀的符号引用
• 定义XML_STATIC时，头文件会生成静态库的函数声明，符号不带前缀

此外，手动指定库文件路径的方式不够可靠，CMake通过FetchContent拉取Expat后，会自动创建expat::expat目标，包含了所有必要的配置（头文件路径、库路径、宏定义等），手动指定路径容易出现配置不匹配的问题。

解决方案 #

1. 定义XML_STATIC宏：在包含Expat头文件前定义该宏，强制使用静态库模式
2. 使用CMake目标链接：放弃手动指定库文件，改用expat::expat目标进行链接，让CMake自动处理所有依赖配置
3. 移除手动头文件路径配置：expat::expat目标已包含所需的头文件路径，无需手动添加

修改后的CMake配置 #

替换原有的Expat配置代码为：

set(EXPAT_SHARED_LIBS OFF)
set(EXPAT_MSVC_STATIC_CRT ON)
# 定义XML_STATIC，强制静态库模式
add_compile_definitions(XML_STATIC)

FetchContent_Declare(
        expat
        GIT_REPOSITORY https://github.com/libexpat/libexpat.git
        GIT_TAG  R_2_6_2
        SOURCE_SUBDIR  expat
        SYSTEM
)
FetchContent_MakeAvailable(expat)

# 直接使用expat::expat目标，无需手动指定库文件和头文件
set(Required_Libraries ${Required_Libraries} expat::expat)

验证修改 #

修改后，链接时CMake会自动：

• 传递XML_STATIC宏给编译器，确保生成静态库兼容的符号引用
• 链接正确的静态库文件（如libexpatMT.lib）
• 包含必要的头文件路径

GitHub工作流无需修改，保持原有的Release配置即可。

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