VSCode 配置 C++ 编译环境

花费了将近一个半小时才把 Windows 运行 VSCode 编译 C 的环境搭建起来，参照 VSCode 的官方文档操作，运行时还是“Duang”的反复报错，网上的帖子有很多，大多数作为入门贴，操作起来着实不方便，而且对一些问题的处理细节不到位，让人照着操作可能会成功，但不知其所以然。 今天把自己的血泪史和理解整理成文章，为常年奋战在 Windows 一线开发的程序员在首次搭建 VSCode 编译环境时提供一点点参考。 废话不多说，一起来看看我今天遇到的坑和解决过程。

1.已经安装 VS2019 Preview 版本。重点不是 Visual Studio 的版本，而是安装时必须选择 C/C++ 运行时库。 2.下载安装 VSCode ，并更新至最新版。

本节不详细介绍操作的具体流程，只是简单罗列关键步骤和文档结果，详细的过程和参数说明见 VSCode 的官方文档：https://code.visualstudio.com/docs/cpp/config-msvc#_the-term-clexe-is-not-recognized

详细内容参见官方文档的操作步骤，虽然是英文，但内容图文并茂关键操作都有高亮显示和工具下载的跳转链接，非常易读，关键步骤如下：

1.创建示例代码，安装编程惯例，第一个程序一定是 HelloWorld，本次也不例外。 新建空文件夹，使用 VSCode 设置为工程目录，使用 VSCode 创建 helloworld.cpp 文件，并加入示例代码。

2.2 创建 launch.json 文件 按照官方文档介绍，创建默认的配置文件如下：

2.3 创建 c_cpp_properties.json 文件 按照官方文档，选择 C/C++ 的 UI 配置方式创建出如下的配置文件：

其中 "compilerPath" 的内容与当前环境已安装的编译器有关，不需要过度关心，如果在 UI 配置环节没有检测到编译器，则需要回到开篇处，先安装相关的 C/C++ 编译器。

配置完毕，开始编译，遇到如下坑：

问题现象：VSCode 在左侧导航栏选择 “Debug” 标签页，运行设置选择配置文件中所罗列的 “cl.exe - 生成和调试活动文件”，操作截图如下： 错误原因：VSCode 的终端无法正常识别 cl.exe ，在终端中输入 cl.exe 果然没有看到帮助信息的提示内容。 解决方案：

方案2（推荐）：使用 MSVC 的命令行工具启动 VSCode，此方式较方案1来说，具有更强的灵活性，对其他工程影响小。

为什么执行 “x64 Native Tools Command Prompt for VS 2019 Preview” 会初始化 MSVC 的环境变量？ 这个问题可以自行百度，有一定基础的程序员可以通过文件属性，查看快捷方式的启动命令，实际上这里的快捷方式是调用 MSVC 命令行工具并在启动时完成当前版本 VS 环境的初始化操作，上述流程对于使用 NMake 构建的开发者来说一定不陌生。

点击 VSCode 左侧的 "Debug" 按钮，选择运行，提示如下错误：

错误原因：从输出的信息来看 cl.exe 编译的文件并非期望的 “helloworld.exe” 和 “helloworld.cpp” 文件而是 task.json 文件，问题就出在这里，创建 task.json 之后需要将参数 “args” 中的参数进行修改，其中包括：

提个小问题，为什么配置文件中不是设置文件的全路径？ 原因是下文的配置选项中已设置工作目录 “cwd”: “${workspaceFolder}”，如果代码文件不在当前工程的根目录则需要写入相对路径。

问题的原因同 task.json 配置，其中 "program": "${fileDirname}\\${fileBasenameNoExtension}.exe" 运行程序的名称并未修改为当前工程的名称， 参照 task.json 将 "${fileDirname}\\${fileBasenameNoExtension}.exe" 内容修改为 "helloworld.exe"，修改配置如下：

再次调试运行，代码进入熟悉的调试界面，熟悉的快捷键，仿佛回到 Visual Studio 的调试。

开始调试程序，让 VSCode 成为日常办公的利器，本篇踩坑记录到此为止。