使用Vcpkg安装tinyxml2并通过CMake链接时遇未定义引用错误求助

问题根源 #

你的链接错误本质是工具链不兼容：你使用MSYS2/MinGW的C++编译器构建项目，但vcpkg默认安装的x64-windows端口是针对MSVC工具链编译的库，MinGW无法直接链接MSVC生成的库文件，因此出现undefined reference错误。

解决步骤 #

1. 清理现有安装 #

先卸载当前不兼容的tinyxml2版本，并清理构建缓存：

vcpkg remove tinyxml2
rm -rf build/  # 或手动删除本地build目录

2. 安装MinGW适配版本的tinyxml2 #

使用vcpkg的MinGW专属triplet安装对应版本的库：

• 若需要静态库（推荐，减少依赖问题）：

  vcpkg install tinyxml2:x64-mingw-static
  

• 若需要动态库：

  vcpkg install tinyxml2:x64-mingw-dynamic
  

可通过vcpkg help triplet查看所有支持的MinGW triplet，根据你的MinGW架构（32/64位、ucrt/msvcrt）选择对应triplet。

3. 修正CMake配置 #

确保CMake使用与安装库匹配的triplet，修改CMakePresets.json添加triplet配置：

{
    "version": 2,
    "configurePresets": [
      {
        "name": "default",
        "generator": "Ninja",
        "binaryDir": "${sourceDir}/build",
        "cacheVariables": {
          "CMAKE_TOOLCHAIN_FILE": "./vcpkg/scripts/buildsystems/vcpkg.cmake",
          "VCPKG_TARGET_TRIPLET": "x64-mingw-static"  # 与安装时的triplet保持一致
        }
      }
    ]
  }

也可在cmake配置时临时指定：cmake --preset=default -DVCPKG_TARGET_TRIPLET=x64-mingw-static

4. 重新构建项目 #

删除原有build目录后，重新执行构建命令：

cmake --preset=default
cmake --build build

额外注意事项 #

• 避免在CMakeLists.txt和CMakePresets.json中重复设置CMAKE_TOOLCHAIN_FILE，建议统一在Presets中配置。
• 运行g++ -v可确认你的MinGW工具链架构和运行时，确保triplet选择正确。

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