Visual Studio Code – C++ 入门 —— 基于 Visual Studio Code 官方文档的全面的、具体的入门级教程

在本教程中，您将为使用 UCRT64 中的 GCC C++ 编译器（g++）和 GDB 调试器配置 Visual Studio Code 来创建在 Windows 上运行的程序。

配置 VS Code 后，您将在 VS Code 中编译和调试一个简单的 Hello World 程序。本教程不会教您有关 GCC，GDB，UCRT64 或 C++ 语言的知识。对于这些主题，网络上有许多很好的资源。

本教程内容较多，但若严格按照本教程操作，就能轻松实现 Visual Studio Code – C++ 入门，所以请耐心完整地学习本教程。如果遇到任何问题，在查询网络后无效的情况下可以与作者联系（在手机上点击此链接）。

先决条件

若要成功完成本教程，必须执行以下步骤：

1. 安装 Visual Studio Code（运行刚下载的安装程序，选择我同意此协议后一直选择下一步，在选择附加任务页面选择所有选项，最后选择安装）。

提示：安装程序会将 Visual Studio Code 添加到您的 PATH，因此您可以从终端键入 code . 以在该文件夹上打开 VS Code。安装后，您需要重新启动终端才能使对环境变量的更改生效。

2. 安装扩展：Chinese (Simplified) Language Pack for Visual Studio Code 和 C/C++。

3. 通过 MSYS2 获取最新版本的 UCRT64，它提供了 GCC，UCRT64 和其他有用的 C++ 工具和库的最新本地版本。按照 MSYS2 官网中的 Installation 说明安装 MSYS2。

4. 安装 UCRT64 工具链。当 MSYS2 已经准备就绪，UCRT64 环境的终端将启动，依次键入：

$ pacman -S tar make
$ pacman -S mingw-w64-ucrt-x86_64-toolchain
$ pacman -Syu

接受默认值（键入 Y）以安装工具链组中的所有成员。

5. 使用以下步骤将 UCRT64 文件夹的路径添加到 Windows 环境变量：

(1)在 Windows 搜索栏中，键入设置以打开 Windows 设置。

(2)搜索编辑帐户的环境变量。

(3)在用户变量中选择变量 Path，然后选择编辑。

(4)选择新建并将 UCRT64 目标文件夹路径添加到系统路径。确切的路径取决于您安装的 UCRT64 安装位置。如果您使用默认路径安装 UCRT64，请将其添加到路径：C:\msys64\ucrt64\bin。选择确定以保存更新的路径。

6. 若要检查 UCRT64 工具是否已正确安装且可用，请打开新的终端并依次键入：

gcc --version
g++ --version
gdb --version

创建 Hello World

在磁盘（可以是任意位置）中创建一个名为 C++_code（可以是其他命名）的空文件夹，您可以在其中放置所有 VS Code 代码。在 VS Code 中打开该文件夹（可以右键单击该文件夹，选择通过 Code 打开），该文件夹将成为您的工作区。通过选择信任文件夹并继续接受工作区信任对话框，因为这是您创建的文件夹。

在学习本教程时，你将看到在工作区中的被 VS Code 创建的文件夹 .vscode 和其中的两个文件：

tasks.json（编译配置）

launch.json（调试器配置）

添加源代码文件

在资源管理器标题栏中，选择新建文件按钮并将文件命名为 helloworld.cpp。

添加 helloworld 源代码

现在复制此源代码粘贴到该文件：

#include <bits/stdc++.h>
 
using namespace std;
 
int main()
{
    cout << "Hello, world!" << endl;
 
    return 0;
}

现在保存文件。

您还可以启用自动保存以自动保存文件更改，方法可以参考后文更多中的 3。

使用最左侧的活动栏可以打开不同的视图，例如搜索、运行和调试和扩展。本教程稍后将查看运行和调试视图。可以在 VS Code 用户界面文档中找到有关其他视图的详细信息。

注意：保存或打开 C++ 文件时，你可能会看到来自 C/C++ 扩展的有关预览体验成员版本可用性的通知，该通知可用于测试新功能和修补程序。您可以通过选择清除所有通知来忽略此通知。

运行 helloworld.cpp

请记住，C++ 扩展使用计算机上安装的 C++ 编译器来生成程序。在尝试在 VS Code 中运行和调试 helloworld.cpp 之前，请确保已安装 C++ 编译器（完成前文先决条件中的 3 ~ 5）。

打开 helloworld.cpp，选择编辑器右上角的开始按钮。

选择 C/C++: g++.exe 生成和调试活动文件。

只有在第一次运行 helloworld.cpp 时才会要求您选择编译器。此编译器将在文件 tasks.json 中设置为默认编译器。

编译成功后，程序的输出将显示在集成终端中。

首次运行程序时 tasks.json 会创建 ，您可以在工作区中的文件夹 .vscode 中找到它。tasks.json 存储编译配置。

将您的新文件 tasks.json 中的全部内容替换为以下内容（注意第 10、11 行代码，可以根据需求其中一行被注释，另一行未被注释，否则无法编译）：

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++:g++.exe 生成活动文件",
            "command": "C:\\msys64\\ucrt64\\bin\\g++.exe", // 编译器路径，如果您使用默认路径安装 UCRT64 则无需修改
            "args": [
               "-fdiagnostics-color=always",
               "-g",
               "${file}", // 仅编译当前打开的源文件
               //"${fileDirname}\\*.cpp", // 编译当前文件夹下的所有源文件
               "-o",
               "${fileDirname}\\${fileBasenameNoExtension}.exe"
           ],
            "options": {
               "cwd": "${fileDirname}"
           },
            "problemMatcher": [
               "$gcc"
           ],
            "group": {
               "kind": "build",
               "isDefault": true
           },
            "detail": "调试器生成的任务。"
        }
    ],
    "version": "2.0.0"
}

调试 helloworld.cpp

返回到 helloworld.cpp。通过单击编辑器左侧边缘来设置断点。

从开始按钮旁边的下拉列表中，选择调试 C/C++ 文件。

从系统上检测到的编译器列表中选择 C/C++:g++.exe生成和调试活动文件（仅在首次运行/调试 helloworld.cpp 时要求您选择编译器，所以一般情况下可以省略该步骤）。

开始按钮有两种模式：运行 C/C++ 文件和调试 C/C++ 文件。它将默认为上次使用的模式。如果在开始按钮中看到调试图标，只需选择开始按钮即可进行调试，而无需使用下拉列表。

探索调试器

在开始单步执行代码之前，让我们花点时间注意用户界面中的几个更改：

集成终端显示在源代码编辑器的底部。

编辑器会突出显示在启动调试器之前设置断点的行。

左侧的运行和调试视图显示调试信息。

在代码编辑器的顶部，将显示调试控制面板。您可以通过托住左侧的点在屏幕上移动它。

单步执行代码

现在，你已准备好开始单步执行代码。

具体操作步骤省略，相关快捷键可以参考附。

最后您可以在集成终端中看到输出，以及 GDB 输出的一些其他诊断信息。

设置监视

有时，您可能希望在程序执行时跟踪变量的值。您可以通过在变量上设置监视来执行此操作。

在监视窗口中，选择加号，然后在文本框中键入变量。现在，在单步执行循环时查看监视窗口。

若要在断点处暂停执行时快速查看任何变量的值，可以使用鼠标指针将鼠标悬停在该变量上。

使用 launch.json 自定义调试

使用开始按钮进行调试时，C++ 扩展会动态创建动态调试配置。

在某些情况下，您需要自定义调试配置，例如指定要在运行时传递给程序的参数。您可以在文件 launch.json 中定义自定义调试配置。

选择设置按钮来创建 launch.json：您将看到各种预定义调试配置的下拉列表，选择 C/C++: g++.exe 生成和调试活动文件，VS Code 会创建一个文件 launch.json。将其中的全部内容替换为以下内容：

{
    "configurations": [
        {
            "name": "C/C++:g++.exe 生成和调试活动文件",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "internalConsoleOptions": "neverOpen",
            "MIMode": "gdb",
            "miDebuggerPath": "C:\\msys64\\ucrt64\\bin\\gdb.exe", // 调试器路径，如果您使用默认路径安装 UCRT64 则无需修改
            "setupCommands": [
               {
                   "description": "为 gdb 启用整齐打印",
                   "text": "-enable-pretty-printing",
                   "ignoreFailures": true
               },
               {
                   "description": "将反汇编风格设置为 Intel",
                   "text": "-gdb-set disassembly-flavorintel",
                   "ignoreFailures": true
               }
           ],
            "preLaunchTask": "C/C++:g++.exe 生成活动文件"
        }
    ],
    "version": "2.0.0"
}

从现在开始，开始按钮将在启动程序进行调试时从您的文件 launch.json 中读取。

更多

1. 前文中 tasks.json 和 launch.json 的内容为作者将默认内容稍作修改后的版本，使 VS Code 更易于使用，具体如下：

(1)在 tasks.json 中，添加

// "${fileDirname}\\*.cpp",

(2)在 launch.json 中，添加

"internalConsoleOptions": "neverOpen",

控制在开始调试后不打开内部调试控制台，而是停留在集成终端，便于输入和查看输出。

2. 推荐安装的拓展：Code Runner，Tabnine AI Autocomplete（非常推荐），vscode-icons。其功能可以参考各自网页中的 Overview，还有其他优秀的拓展可以自行探索。

3. 为了使 VS Code更易于使用，可以通过以下方法进行 VS Code 用户设置：

在 %AppData%\Code\User 中创建 JSON 文件 setting.json（可以先新建文本文档，然后重命名为 setting.json，然后用 VS Code 打开，下 4 同），内容如下（其中包含前文的自动保存的设置）：

{
    "editor.formatOnPaste": true,
    "editor.formatOnSave": true,
    "editor.formatOnType": true,
    "editor.minimap.enabled": false,
    "editor.codeActionsOnSave": {
       "source.organizeImports": true,
       "source.fixAll": true
    },
    "editor.wordWrap": "on",
    "terminal.integrated.allowChords": false,
    "terminal.integrated.enableMultiLinePasteWarning": false,
    "explorer.confirmDelete": false,
    "explorer.confirmDragAndDrop": false,
    "window.autoDetectColorScheme": true,
    "debug.onTaskErrors": "showErrors",
    "files.autoSave": "afterDelay",
    "workbench.iconTheme": "vscode-icons",
    "tabnine.experimentalAutoImports": true,
    "tabnine.receiveBetaChannelUpdates": true,
    "code-runner.clearPreviousOutput": false,
    "code-runner.preserveFocus": true, 
    "code-runner.runInTerminal": true,
    "code-runner.saveFileBeforeRun": true
}

4．为了将每次编译后产生的 EXE 等类型的文件删除，在工作区中创建 BAT 文件 .del.bat，内容如下：

del *.exe /q /s
del a.out /q /s
del *.o /q /s
del *.log /q /s
deltempCodeRunnerFile.c /q /s

在资源管理器中右键选择 .del.bat，选择 Run Code（前提是已安装拓展 Code Runner）。

5. 为了在运行 VS Code 的同时打开作为工作区的文件夹，可以右键选择其快捷方式，选择属性，在目标后添加工作区的路径，如："C:\Program Files\Microsoft VS Code\Code.exe" "C:\C++_code"，选择确定。

6. 作为在全球范围内最受程序员欢迎的代码编辑器，VS Code 具有许多优秀的特点，可以帮助您轻松编写代码，您可以自行探索。

7. VS Code 还提供内部版本 Visual Studio Code Insiders，可以安装其来获取每天的最新版本。

8. 本教程的相关图片（英文版）和其他的相关内容（包含更深入的非入门级教程）可以参考 Visual Studio Code 官方文档。

9. 由于作者水平有限，本教程可能存在一些不足，欢迎读者将发现的错误或提出的意见与建议告知作者（在手机上点击此链接）。

附