CMake+VCPKG：Windows VC构建平台工具集验证及链接问题排查

我有一个跨Windows和Linux的CMake项目，由于用户仍在使用VS2019的v142工具集，Windows端构建时通过自定义vcpkg triplet指定VCPKG_PLATFORM_TOOLSET为v142，并设置VCPKG_TARGET_TRIPLET缓存变量为该自定义triplet名称（已清理CMake缓存并重新配置构建）。

自定义triplet内容如下：

set(VCPKG_TARGET_ARCHITECTURE x86)
set(VCPKG_CRT_LINKAGE dynamic)
set(VCPKG_LIBRARY_LINKAGE static)
set(VCPKG_PLATFORM_TOOLSET "v142")

项目构建流程正常，vcpkg输出也显示使用了指定的triplet，但Release构建链接静态库时出现错误，Debug构建无异常：

1>LINK : fatal error C1007: unrecognized flag '-Zc:nrvo' in 'p2'
1>LINK : fatal error LNK1257: code generation failed

我未显式设置-Zc:nrvo标志，但该标志仅支持VS2022 17.4及以上版本（v143工具集），且开启permissive-时会被最新工具集自动启用（我项目中使用了permissive-）。因此推断依赖库可能实际使用了v143工具集编译，而非指定的v142。

已尝试的操作：

• 给vcpkg添加--debug参数，查看vcpkg-manifest-install.log，仅主机triplet的编译器检测环节出现v143相关内容，目标构建环节显示使用了自定义triplet，未发现异常。
• 设置VCPKG_HOST_TRIPLET为自定义triplet，错误未改变，仅日志中v143的引用被移除。

1. 验证依赖库的实际编译工具集 #

使用VS自带的dumpbin工具检查静态库的编译信息：

dumpbin /headers your_static_lib.lib | findstr /i "toolset"

若输出包含v143，则证明依赖库确实用了错误的工具集编译。也可查看库的PDB文件（若存在），直接确认编译时使用的工具集版本。

2. 强制vcpkg用v142工具集编译所有依赖 #

• 确保自定义triplet文件路径正确：放在vcpkg的triplets目录下，或通过VCPKG_OVERLAY_TRIPLETS变量指定路径，文件名需符合x86-windows-[name].cmake的格式，保证CMake能正确识别。
• 显式指定triplet执行vcpkg安装，避免缓存干扰：

  vcpkg install --triplet x86-windows-custom
  

• 检查vcpkg的installed目录：查看installed/x86-windows-custom/share下的包配置文件，确认是否有v142工具集的标识。

3. 强制CMake传递v142工具集参数 #

在CMake配置阶段显式指定VS工具集，避免vcpkg自动选取最新版本：

if(WIN32)
  set(CMAKE_GENERATOR_TOOLSET v142 CACHE STRING "Visual Studio toolset version" FORCE)
endif()

同时在CMake命令行中明确传递工具集参数：

cmake -G "Visual Studio 16 2019" -A Win32 -T v142 -DVCPKG_TARGET_TRIPLET=x86-windows-custom ..

4. 显式禁用-Zc:nrvo标志 #

若确认是permissive-触发了该标志的自动启用，可在CMake中针对Release构建显式禁用：

if(WIN32 AND MSVC AND CMAKE_BUILD_TYPE STREQUAL "Release")
  target_compile_options(your_project_target PRIVATE /Zc:nrvo-)
endif()

注意需确保该选项覆盖所有编译单元，包括vcpkg引入的依赖库（若库的构建脚本允许覆盖编译选项）。

5. 彻底清理vcpkg缓存与已安装包 #

删除vcpkg中对应triplet的已安装文件和临时构建文件，重新安装依赖：

rmdir /s /q vcpkg\installed\x86-windows-custom
rmdir /s /q vcpkg\buildtrees
vcpkg install --triplet x86-windows-custom

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