在 VS Code 中在 Linux 上使用 C++

在 VS Code 中在 Linux 上使用 C++

linux调试c++有一点小麻烦 那些jason文件看不太懂，网上搜了好多文章，尝试无果，突然想起来看看官网怎么搞的。传送门：
官网链接：https://code.visualstudio.com/docs/cpp/config-linux
以下是谷歌翻译，翻译的比较粗略，凑乎看看吧~表述不清楚，影响理解的直接官网走起。

官网教程

在本教程中，您将配置 Visual Studio Code 以在 Linux 上使用 GCC C++ 编译器 (g++) 和 GDB 调试器。GCC 代表 GNU 编译器集合；GDB 是 GNU 调试器。

配置 VS Code 后，您将在 VS Code 中编译和调试一个简单的 C++ 程序。本教程不教您 GCC、GDB、Ubuntu 或 C++ 语言。对于这些主题，Web 上有许多很好的资源可用。

如果您遇到问题，请随时在VS Code 文档存储库中为本教程提交问题。

先决条件

要成功完成本教程，您必须执行以下操作：
1.安装Visual Studio 代码。
2.安装VS Code的C++ 扩展。您可以通过在扩展视图 ( kb(workbench.view.extensions)) 中搜索“c++”来安装 C/C++ 扩展。

确保安装了 GCC

尽管您将使用 VS Code 来编辑源代码，但您将使用 g++ 编译器在 Linux 上编译源代码。您还将使用 GDB 进行调试。这些工具默认没有安装在 Ubuntu 上，所以你必须安装它们。幸运的是，这很容易。

首先，检查是否已经安装了 GCC。要验证是否是，请打开终端窗口并输入以下命令：

gcc -v

如果未安装 GCC，请从终端窗口运行以下命令以更新 Ubuntu 软件包列表。过时的 Linux 发行版有时会干扰安装新软件包的尝试。

sudo apt-get update

接下来使用以下命令安装 GNU 编译器工具和 GDB 调试器：

sudo apt-get install build-essential gdb

创建hello world

在终端窗口中，创建一个名为的空文件夹projects来存储您的 VS Code 项目。然后创建一个名为 的子文件夹helloworld，导航到其中，然后通过输入以下命令在该文件夹中打开 VS Code：

mkdir项目
cd项目
mkdir helloworld
 cd helloworld
 code.

该code .命令会在当前工作文件夹中打开 VS Code，该文件夹将成为您的“工作区”。在学习本教程时，您将.vscode在工作区的文件夹中创建三个文件：
·tasks.json （编译器构建设置）
·launch.json （调试器设置）
·c_cpp_properties.json （编译器路径和 IntelliSense 设置）

添加hello world源代码文件

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

粘贴以下源代码：

#include <iostream>
#include <vector>
#include <string>

using namespace std;

int main()
{
    vector<string> msg {"Hello", "C++", "World", "from", "VS Code", "and the C++ extension!"};

    for (const string& word : msg)
    {
        cout << word << " ";
    }
    cout << endl;
}

现在按Ctrl+s保存文件。请注意，您的文件列在VS Code 侧栏中的文件资源管理器视图 Ctrl+Shift+e中：

您还可以启用自动保存自动保存文件的变化，通过检查自动保存在主文件菜单。

Visual Studio Code 边缘的 Activity Bar 可让您打开不同的视图，例如Search、Source Control和Run。您将在本教程后面查看Run视图。您可以在 VS Code用户界面文档中找到有关其他视图的更多信息。

注意：当您保存或打开 C++ 文件时，您可能会看到来自 C/C++ 扩展的关于 Insiders 版本可用性的通知，它允许您测试新功能和修复。您可以通过选择X(清除通知)来忽略此通知。

探索智能感知(Explore IntelliSense)

在helloworld.cpp文件中，将鼠标悬停在vector或 上string以查看类型信息。在msg变量声明之后，开始msg.像调用成员函数一样键入。您应该立即看到一个显示所有成员函数的完成列表，以及一个显示msg对象类型信息的窗口：

您可以按kbstyle(Tab)键插入所选成员。然后，当您添加左括号时，您将看到有关函数所需参数的信息。

*[注意：当您保存或打开 C++ 文件时，您可能会看到来自 C/C++ 扩展的关于 Insiders 版本可用性的通知，它允许您测试新功能和修复。您可以通过选择X(清除通知)来忽略此通知。]

构建 helloworld.cpp

接下来，您将创建一个tasks.json文件来告诉 VS Code 如何构建（编译）程序。此任务将调用 g++ 编译器从源代码创建一个可执行文件。

helloworld.cpp在编辑器中打开很重要，因为下一步使用编辑器中的活动文件作为上下文来创建下一步中的构建任务。

从主菜单中，选择“Terminal > Configure Default Build Task”。出现一个下拉菜单，显示 C++ 编译器的各种预定义构建任务。选择C/C++: g++ build active file。

这将tasks.json在.vscode文件夹中创建一个文件并在编辑器中打开它。

您的新tasks.json文件应该类似于下面的 JSON：

{
"version": "2.0.0",
"tasks": [
    {
        "type": "shell",
        "label": "g++ build active file",
        "command": "/usr/bin/g++",
        "args": [
            "-g",
            "${file}",
            "-o",
            "${fileDirname}/${fileBasenameNoExtension}"
        ],
        "options": {
            "cwd": "/usr/bin"
        },
        "problemMatcher": [
            "$gcc"
        ],
        "group": {
            "kind": "build",
            "isDefault": true
        }
    }
]
}

*[注意：您可以tasks.json在变量参考中了解有关变量的更多信息。]

该command设置指定要运行的程序；在这种情况下是 g++。该args数组指定将传递给 g++ 的命令行参数。这些参数必须按照编译器预期的顺序指定。

这个任务告诉 g++ 获取活动文件 ( ${file})，编译它，并在当前目录 ( ${fileDirname}) 中创建一个与活动文件同名但没有扩展名 ( ${fileBasenameNoExtension})的可执行文件，导致helloworld我们的例子。

该label值是您将在任务列表中看到的值；你可以随意命名它。

对象中的"isDefault": true值group指定当您按下 时将运行此任务kb(workbench.action.tasks.build)。此属性仅为方便起见；如果您将其设置为 false，您仍然可以使用Tasks: Run Build Task从终端菜单运行它。

运行构建

1.回到helloworld.cpp. 您的任务会构建活动文件，而您想要构建helloworld.cpp.
2.要运行中定义的构建任务tasks.json，请按+或 从终端主菜单中选择运行构建任务。
3.任务开始时，您应该会看到集成终端面板出现在源代码编辑器下方。任务完成后，终端会显示编译器的输出，指示构建是成功还是失败。对于成功的 g++ 构建，输出如下所示：

4.使用+按钮创建一个新终端，您将拥有一个运行默认 shell 的终端，并将该helloworld文件夹作为工作目录。运行ls，您现在应该会看到可执行文件helloworld（无文件扩展名）。

5.您可以helloworld通过键入在终端中运行./helloworld。

修改tasks.json

您可以tasks.json通过使用类似的参数"${workspaceFolder}/*.cpp"而不是${file}.您还可以通过替换"${fileDirname}/${fileBasenameNoExtension}"为硬编码文件名（例如“helloworld.out”）来修改输出文件名。

调试 helloworld.cpp

接下来，您将创建一个launch.json文件来配置 VS Code，以便在您按下kb(workbench.action.debug.start)调试程序时启动 GDB 调试器。

从主菜单中，选择Run > Add Configuration…，然后选择C++ (GDB/LLDB)。

然后，您将看到各种预定义调试配置的下拉列表。选择g++ build and debug active file。

VS Code 创建一个launch.json文件，在编辑器中打开它，然后构建并运行“helloworld”。

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "g++ build and debug active file",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "g++ build active file",
            "miDebuggerPath": "/usr/bin/gdb"
        }
    ]
}

在上面的 JSON 中，program指定要调试的程序。此处设置为活动文件夹$fileDirname和活动文件名，没有扩展名${fileBasenameNoExtension}，如果helloworld.cpp是活动文件，则为helloworld.
默认情况下，C++ 扩展不会向您的源代码添加任何断点，并且该stopAtEntry值设置为false.
将stopAtEntry值更改true为使调试器main在您开始调试时停止该方法。

启动调试会话

返回以helloworld.cpp使其成为活动文件。
按F5或 从主菜单中选择Run > Start Debugging。在开始逐步执​​行代码之前，让我们花点时间注意一下用户界面中的几个变化：
集成终端出现在源代码编辑器的底部。在“调试输出”选项卡中，您会看到指示调试器已启动并正在运行的输出。

编辑器突出显示方法中的第一条语句main。这是 C++ 扩展自动为您设置的断点：

左侧的运行视图显示调试信息。您将在本教程后面看到一个示例。
在代码编辑器的顶部，会出现一个调试控制面板。您可以通过抓住左侧的点在屏幕上移动它。

逐步执行代码

现在您已准备好开始逐步执​​行代码。

1.单击或按调试控制面板中的Step over图标。

这会将程序执行推进到 for 循环的第一行，并跳过在创建和初始化变量时调用的vector和string类中的所有内部函数调用msg。请注意侧面“变量”窗口中的更改。

2.再次按Step over前进到该程序中的下一条语句（跳过为初始化循环而执行的所有内部代码）。现在，变量窗口显示有关循环变量的信息。

3.再次按Step over执行cout语句。（请注意，自 2019 年 3 月发布以来，C++ 扩展在最后一次 cout 执行之前不会将任何输出打印到调试控制台。）

4.如果你愿意，你可以一直按Step over直到向量中的所有单词都被打印到控制台。但是，如果您感到好奇，请尝试按Step Into按钮来逐步浏览 C++ 标准库中的源代码！

要返回到您自己的代码，一种方法是一直按Step over。另一种方法是在代码中设置断点，方法是切换到helloworld.cpp代码编辑器中的选项卡，将插入点放在cout循环内语句的某个位置，然后按F9。左边的装订线中出现一个红点，表示该行已设置断点。

然后按F5从标准库头文件的当前行开始执行。执行将中断cout。如果您愿意，可以F9再次按下以关闭断点。

循环完成后，您可以在集成终端的调试控制台选项卡中看到输出，以及 GDB 输出的其他一些诊断信息。

设置watch窗口

要在程序执行时跟踪变量的值，请对变量设置监视。

1.将插入点放在循环内。在Watch窗口中，单击加号，然后在文本框中键入word，这是循环变量的名称。现在在您逐步执行循环时查看 Watch 窗口。

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

C/C++ 配置

如果您想要更多地控制 C/C++ 扩展，您可以创建一个c_cpp_properties.json文件，该文件将允许您更改设置，例如编译器路径、包含路径、C++ 标准（默认为 C++17）等。

您可以通过从命令面板 ( )运行命令C/C++: Edit Configurations (UI)来查看 C/C++ 配置 UI Ctrl+Shift+P。

这将打开C/C++ 配置页面。当您在此处进行更改时，VS Code 会将它们写入文件夹中名为c_cpp_properties.json的.vscode文件。

如果您的程序包含不在您的工作区或标准库路径中的头文件，您只需要修改包含路径设置。

Visual Studio Code 将这些设置放在.vscode/c_cpp_properties.json. 如果您直接打开该文件，它应该如下所示：

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/**"
            ],
            "defines": [],
            "compilerPath": "/usr/bin/gcc",
            "cStandard": "c11",
            "cppStandard": "c++17",
            "intelliSenseMode": "clang-x64"
        }
    ],
    "version": 4
}

重用你的 C++ 配置

VS Code 现在配置为在 Linux 上使用 gcc。该配置适用于当前工作空间。要重用配置，只需将 JSON 文件复制到.vscode新项目文件夹（工作区）中的文件夹，并根据需要更改源文件和可执行文件的名称。

故障排除

编译器和链接错误
当您开始构建或开始调试时，最常见的错误原因（例如undefined _main、 或attempting to link with file built for unknown-unsupported file format等）发生在helloworld.cpp不是活动文件时。这是因为编译器试图编译的东西是不是源代码，喜欢你的launch.json，tasks.json或c_cpp_properties.json文件。