使用vscode-cpptools遇cl.exe报错：需从VS开发者命令提示符启动VS Code

cl.exe是Visual Studio自带的C/C++编译器，它的正常运行依赖Visual Studio开发者环境的一系列环境变量（包括工具链路径、头文件目录、库文件目录等）。如果直接双击打开VS Code，系统的环境变量中并不包含这些VS专属配置，导致vscode-cpptools扩展无法正确调用cl.exe，从而触发该错误。

• 从开发者命令提示符启动VS Code
  找到对应你Visual Studio版本的“Developer Command Prompt for VS”（比如VS2022的命令提示符），打开后输入code并回车启动VS Code。这种方式下，VS Code会继承命令提示符中的VS环境变量，扩展就能正常调用cl.exe了。

• 手动在VS Code配置中添加环境变量
  打开项目下的.vscode/c_cpp_properties.json文件，在配置项的env字段中手动填入VS工具链的环境变量，示例配置如下：

  {
    "configurations": [
      {
        "name": "Win32",
        "includePath": ["${workspaceFolder}/**"],
        "defines": ["_DEBUG", "UNICODE", "_UNICODE"],
        "compilerPath": "C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.38.33130/bin/Hostx64/x64/cl.exe",
        "cStandard": "c17",
        "cppStandard": "c++17",
        "intelliSenseMode": "windows-msvc-x64",
        "env": {
          "PATH": "C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.38.33130/bin/Hostx64/x64;${env:PATH}",
          "INCLUDE": "C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.38.33130/include;C:/Program Files (x86)/Windows Kits/10/Include/10.0.22621.0/ucrt;C:/Program Files (x86)/Windows Kits/10/Include/10.0.22621.0/shared;C:/Program Files (x86)/Windows Kits/10/Include/10.0.22621.0/um;C:/Program Files (x86)/Windows Kits/10/Include/10.0.22621.0/winrt;${env:INCLUDE}",
          "LIB": "C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.38.33130/lib/x64;C:/Program Files (x86)/Windows Kits/10/Lib/10.0.22621.0/ucrt/x64;C:/Program Files (x86)/Windows Kits/10/Lib/10.0.22621.0/um/x64;${env:LIB}"
        }
      }
    ],
    "version": 4
  }
  

  注意根据自己的VS安装版本、路径以及Windows Kits版本修改上述配置中的路径。

• 通过任务脚本初始化环境后编译
  在项目的.vscode/tasks.json中创建编译任务，先调用VS的环境初始化脚本vcvars64.bat（对应64位环境，32位用vcvars32.bat），再执行编译命令，示例配置：

  {
    "version": "2.0.0",
    "tasks": [
      {
        "label": "MSVC Build",
        "type": "shell",
        "command": "\"C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Auxiliary/Build/vcvars64.bat\" && cl.exe /EHsc your_source_file.cpp",
        "group": {
          "kind": "build",
          "isDefault": true
        },
        "problemMatcher": ["$msCompile"]
      }
    ]
  }
  

  替换脚本路径和your_source_file.cpp为你项目的实际源文件名即可。

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