这是一份面向初学者的 VS Code C++ 环境指南。我注意到网络上许多配置教程只是丢给你一堆写好的 .json 文件然后叫你放在 ./vscode 目录底下，一点不解释它们是什么、这些设置是什么意思。因此我参考了 VS Code 官方文档中的步骤，编写了一份新的教程，力求步骤简洁、配置干净，除必要的设置外不引入乱七八糟的杂项，并解释了配置文件的具体含义，让初学者能“知其所以然”。

确保你安装了 MinGW。MinGW 提供了 Windows 下编写 C++ 代码所必需的编译器、调试器以及标准库头文件。你应该可以在你的 MinGW 目录中 bin 文件夹找到 gcc.exe、g++.exe、gdb.exe。你可以简单地将 gcc、g++ 理解为编译器，将 gdb 理解为调试器。

你需要将这三个可执行程序所在的目录（即“你的 MinGW 目录/bin/”）添加到 PATH。它可以让你在终端中直接调用这三个程序。在终端中分别执行以下命令以确定是否成功，它们会打印出本机 gcc、g++、gdb 的版本：

如果终端向你抱怨“无法将“gcc”项识别为什么什么什么”或者“'gcc' 不是内部或外部命令，也不是可运行的程序”之类的错误，检查你是否正确安装了 MinGW，并正确设置了 PATH 环境变量。

如何安装 MinGW？什么是 PATH？你可以参考 VS Code 官方文档 的开头。如果你不想单单为了一个 MinGW 就下载 MSYS2，也可以参考网上的教程。建议你尽量确保你的 MinGW 版本是最新的。

终端也就是命令行，例如 Windows 自带的 cmd、PowerShell等。

C/C++ 扩展可以为你提供代码补全、智能提示等功能，尽管我非常建议你启用它（或 Clangd）以获取这些功能，但它并不是编译运行 C++ 代码所必需的（不要误解，它并不是你的编译器）。

如果你没有设置 PATH，C/C++ 扩展可能找不到你的编译器。

它的设置可以在 活动栏（Activity Bar） -> 扩展 -> C/C++ -> 小齿轮图标 -> 扩展设置里完成。如果你看不懂，没有关系，全部按照默认来就好。

需要留意的是，该扩展使用 compilerPath 设置推断 C++ 标准库头文件的位置（因为通常编译器和这些头文件在同一个位置），扩展会先查找 MSVC 编译器，后查找 WSL g++，最后查找 MinGW g++。如果它的设定与你希望的相违背，你可以将其设置为你想要的路径，例如 C:\mingw64\bin\g++.exe。这通常可以解决诸如 “编译器为什么找不到 iostream” 的问题。你还可以直接更改插件设置中的 Include Path 或 System Include Path，例如添加 "C:/mingw64/include/**"（“**”表示在此目录下递归地搜索头文件）。

打开 VS Code，新建工作区，并在工作区中添加一个 C++ 源文件（例如，helloworld.cpp）。随意写入一段代码：