Visual Studio运行CMake C++项目提示找不到C/CXX编译器如何解决？

问题核心是Visual Studio的CMake配置没有正确继承MSVC的编译环境变量：MSVC编译除了需要cl.exe所在的PATH，还需要INCLUDE、LIB、LIBPATH等配套环境变量，单独加PATH无法满足编译要求，同事无需额外配置是因为他们的CMake配置正确继承了Visual Studio自带的MSVC编译环境。

以下是按优先级排序的解决方案： #

方案1：修正CMake配置的环境继承规则（首选） #

无需手动指定路径，适配VS自动更新。

如果你使用CMakeSettings.json（旧版VS默认配置） #

1. 在VS顶部菜单栏选择「项目」→「CMake设置 for 你的项目名称」
2. 点击配置页右上角的「编辑JSON」切换到JSON编辑视图
3. 找到x64-Debug对应的配置段，添加inheritEnvironments字段，示例配置如下：

{
  "configurations": [
    {
      "name": "x64-Debug",
      "generator": "Ninja",
      "configurationType": "Debug",
      "inheritEnvironments": [ "msvc_x64_x64" ],
      "buildRoot": "${projectDir}\\out\\build\\${name}",
      "installRoot": "${projectDir}\\out\\install\\${name}",
      "cmakeCommandArgs": "",
      "buildCommandArgs": "",
      "ctestCommandArgs": ""
    }
  ]
}

4. 保存文件后VS会自动触发CMake重新配置。

如果你使用CMakePresets.json（新版VS默认配置） #

在对应配置段添加VS环境继承规则，示例如下：

{
  "configurePresets": [
    {
      "name": "x64-debug",
      "displayName": "x64 Debug",
      "generator": "Ninja",
      "binaryDir": "${sourceDir}/out/build/${presetName}",
      "installDir": "${sourceDir}/out/install/${presetName}",
      "architecture": {
        "value": "x64",
        "strategy": "external"
      },
      "vendor": {
        "microsoft.com/VisualStudio": {
          "inheritEnvironments": [ "msvc_x64_x64" ]
        }
      },
      "cacheVariables": {
        "CMAKE_BUILD_TYPE": "Debug"
      }
    }
  ]
}

方案2：修复Visual Studio安装组件 #

如果配置正确仍报错，大概率是VS的C++开发组件缺失：

1. 打开Visual Studio Installer，点击对应版本右侧的「修改」按钮
2. 在「工作负载」标签页确认勾选了「使用C++的桌面开发」
3. 在右侧「可选组件」列表确认勾选以下组件：
   • 对应版本的MSVC x64/x86生成工具（如MSVC v143 - VS 2022 C++ x64/x86生成工具）
   • 最新版Windows 10/11 SDK
   • C++ CMake工具
4. 点击「修改」完成组件安装后重启Visual Studio。

方案3：清理CMake缓存重新生成 #

旧的错误缓存会导致配置不生效：
在VS顶部菜单栏选择「项目」→「删除缓存并重新配置CMake」，等待自动完成配置流程即可。 #

方案4：手动指定编译器路径（应急方案，不推荐长期使用） #

如果以上方案都无效，可以手动指定编译器路径，在CMake配置的cacheVariables段添加以下配置，替换为你本地实际的cl.exe路径：

"cacheVariables": {
  "CMAKE_C_COMPILER": "C:/Program Files/Microsoft Visual Studio/2022/Preview/VC/Tools/MSVC/<你的MSVC版本号>/bin/Hostx64/x64/cl.exe",
  "CMAKE_CXX_COMPILER": "C:/Program Files/Microsoft Visual Studio/2022/Preview/VC/Tools/MSVC/<你的MSVC版本号>/bin/Hostx64/x64/cl.exe"
}

注意事项 #

不要手动修改系统环境变量添加MSVC路径：MSVC路径会随版本更新变化，且仅加PATH缺少INCLUDE、LIB等必要环境，即使找到cl.exe也无法正常编译链接。

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