VSCode中CMakeTools无法在CMakePresets.json用环境变量设CMAKE_TOOLCHAIN_FILE

核心原因 #

出现这个错误的本质是CMakeTools没有正确读取到VCPKG_ROOT环境变量，导致路径中的变量部分被解析为空，最终只剩下/scripts/buildsystems/vcpkg.cmake，从而找不到工具链文件。

具体排查与解决步骤 #

• 重启VSCode：修改系统环境变量后，已运行的VSCode进程不会自动刷新环境变量。关闭并重新打开VSCode，让它重新加载系统环境变量，这是最常见的解决方式。
• 手动在VSCode配置中指定变量：如果重启后仍无效，直接在VSCode的settings.json中添加强制配置，绕过系统环境变量的读取问题：

  "cmake.environment": {
      "VCPKG_ROOT": "D:/Apps/vcpkg/vcpkg"
  }
  

• 检查CMake版本：CMake 3.20及以上版本才支持在CMakePresets.json的cacheVariables中使用$env{VAR}语法引用环境变量。如果你的CMake版本低于3.20，要么升级CMake，要么改用完整路径。
• 验证环境变量是否生效：在VSCode的终端中执行对应命令检查变量：
  • PowerShell：echo $env:VCPKG_ROOT
  • Cmd：echo %VCPKG_ROOT%
    如果终端无法输出正确路径，说明VSCode确实没读取到变量，优先尝试重启或手动配置。

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