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

由于自己菜鸟原因，自己在网上找了很多所谓的方法，都没有解决编译调试运行的问题。

        具体我说一下什么问题吧，我在Linux的操作系统上安装了vscode，但是我新建文件写了一个C语言的程序，然后我点调试运行都不行一直跳launch.json,我就没搞明白哪里错了，去网上找教程，看别人说的都试了一下，结果还是不行，直到我找了很久看到的下面这篇文章我才明白，应该要从终端先建立开始才行的。

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

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

如果您遇到问题，请随时在 VS Code 文档存储库 。

先决条件 # 

要成功完成本教程，您必须执行以下操作：

1. 安装 Visual Studio 代码 。

2. 安装 C++ 扩展 。 中搜索“c++”来安装 C/C++ 扩展 Ctrl+Shift+X )

   

 

确保已安装 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

创建你好世界 # 

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

mkdir projects
cd projects
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 保存文件。 请注意，您的文件列在 文件资源管理器 视图 ( Ctrl+Shift+E VS Code 侧栏中

您还可以 自动保存 以自动保存文件更改 自动 主 文件 菜单

Visual Studio Code 边缘的活动栏允许您打开不同的视图，例如 搜索 、 源代码管理 和 运行 。 您将 运行 在本教程的后面 中找到有关其他视图的更多信息 用户界面文档 。

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

探索 IntelliSense # 

在里面 helloworld.cpp文件，悬停在 vector或者 string查看类型信息。 宣布后 msg变量，开始输入 msg.就像调用成员函数时一样。 您应该立即看到一个显示所有成员函数的完成列表，以及一个显示类型信息的窗口 msg目的：

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

构建 helloworld.cpp # 

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

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

从主菜单中，选择 终端 > 配置默认构建任务 。 将出现一个下拉列表，显示 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中的 变量引用 。

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

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

这 labelvalue 是您将在任务列表中看到的内容； 你可以随意命名它。

这 "isDefault": true中的价值 group时将运行此任务 Ctrl+Shift+B 。 此属性仅为方便起见； 如果您将其设置为 false，您仍然可以从 Terminal 菜单中使用 Tasks: Run Build Task 。

运行构建 # 

1. 返回 helloworld.cpp. 您的任务构建活动文件并且您想要构建 helloworld.cpp.

2. 运行定义的构建任务 tasks.json，按 Ctrl+Shift+B 或从 终端 主菜单中选择 Run Build Task 。

3. 当任务开始时，您应该会看到集成终端面板出现在源代码编辑器下方。 任务完成后，终端会显示编译器的输出，指示构建是成功还是失败。 对于成功的 g++ 构建，输出如下所示：

   

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

   

5. 你可以跑 helloworld在终端中键入 ./helloworld.

修改tasks.json # 

你可以修改你的 tasks.json使用类似的参数构建多个 C++ 文件 "${workspaceFolder}/*.cpp"代替 ${file}. 您还可以通过替换来修改输出文件名 "${fileDirname}/${fileBasenameNoExtension}"带有硬编码的文件名（例如“helloworld.out”）。

调试 helloworld.cpp # 

接下来，您将创建一个 launch.json文件以配置 VS Code 以在您按 F5 调试程序时启动 GDB 调试器。

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

然后，您将看到各种预定义调试配置的下拉列表。 选择 g++ 构建和调试活动文件 。

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开始调试时的方法。

开始调试会话 # 

1. 返回 helloworld.cpp使其成为活动文件。
2. 按 F5 或从主菜单中选择 Run > Start Debugging 。 在开始单步执行代码之前，让我们花点时间注意用户界面中的一些变化：

• 集成终端出现在源代码编辑器的底部。 在“ 调试输出 选项卡中，您会看到指示调试器已启动并正在运行的输出。

• 编辑突出显示了第一个声明 main方法。 这是 C++ 扩展自动为您设置的断点：

  

• 左侧的运行视图显示调试信息。 您将在本教程后面看到一个示例。

• 在代码编辑器的顶部，会出现一个调试控制面板。 您可以通过抓住左侧的点来在屏幕上移动它。

  

单步执行代码 # 

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

1. 单击或按 跳过 ”图标。

   

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

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

3. 按 Step over 执行 cout陈述。 不会将任何输出打印到 调试控制台 在最后一个 cout 执行之前

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

   

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

   

    

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

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

   

 

设置手表 # 

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

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

   

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

   

    

C/C++ 配置 # 

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

您可以通过运行命令 C/C++: Edit Configurations (UI) from the Command Palette ( Ctrl+Shift+P ) 来查看 C/C++ 配置 UI。

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

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

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

重用你的 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文件。