Ubuntu 環(huán)境下的 C/C++ 編譯與調試配置方法

更新時間：2024年11月28日 11:49:10 作者：FHKHH

本文檔詳細介紹了如何在Ubuntu環(huán)境中使用VSCode進行C/C++的編譯與調試配置,通過配置`tasks.json`和`launch.json`,實現了統一管理輸出文件、優(yōu)化調試流程以及跨平臺兼容性,配置了`g++`編譯器和`gdb`調試器,并使用C/C++插件來提高開發(fā)效率,感興趣的朋友跟隨小編一起看看吧

統一管理輸出文件：將所有編譯生成的可執(zhí)行文件統一存放到項目的 build 目錄。
優(yōu)化調試流程：調試器自動定位 build 中的可執(zhí)行文件，免去手動調整路徑的麻煩。
跨平臺兼容性：確保配置適用于 Ubuntu 和其他類 Unix 系統。

前提條件

在開始之前，請確保系統已安裝以下工具：

g++ 編譯器
安裝命令：

sudo apt install g++

gdb 調試器
安裝命令：

sudo apt install gdb

VS Code 擴展：

C/C++ 插件（Microsoft 提供）：在擴展市場中搜索 “C/C++” 并安裝。

創(chuàng)建項目目錄結構

建議項目目錄結構如下：

project-root/
├── build/           # 編譯生成的可執(zhí)行文件目錄
├── src/             # 源代碼文件目錄
│   ├── main.cpp     # 示例源代碼文件
├── tasks.json       # VS Code 任務配置文件
└── launch.json      # VS Code 調試配置文件

執(zhí)行以下命令創(chuàng)建目錄結構：

mkdir -p project-root/build
mkdir -p project-root/src

將你的源代碼放入 src 目錄，例如創(chuàng)建一個簡單的 main.cpp：

#include <iostream>
int main() {
    std::cout << "Hello, World!" << std::endl;
    return 0;
}

配置 tasks.json 文件路徑

將 tasks.json 保存到項目目錄下的 .vscode 文件夾中。如果文件夾不存在，使用以下命令創(chuàng)建：

mkdir -p project-root/.vscode
touch project-root/.vscode/tasks.json

完整配置內容

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++ 編譯到 build 目錄 (Ubuntu)",
            "command": "/usr/bin/g++",
            "args": [
                "-fdiagnostics-color=always",   // 彩色錯誤提示
                "-g",                          // 啟用調試信息
                "${workspaceFolder}/src/${fileBasename}", // 指定源文件路徑
                "-o",                          // 輸出選項
                "${workspaceFolder}/build/${fileBasenameNoExtension}" // 輸出文件路徑
            ],
            "options": {
                "cwd": "${workspaceFolder}"     // 設置工作目錄為項目根目錄
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true              // 默認構建任務
            },
            "detail": "將當前活動文件編譯到 build 目錄中"
        }
    ]
}

關鍵解釋

${workspaceFolder}：指代項目根目錄。
${fileBasename}：當前活動文件的文件名（包括擴展名）。
${fileBasenameNoExtension}：當前活動文件的文件名（不包括擴展名）。
-g：開啟調試符號，支持調試功能。

配置 launch.json 文件路徑

將 launch.json 保存到 .vscode 文件夾中：

touch project-root/.vscode/launch.json

完整配置內容

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "C/C++ Runner: Debug Session",
      "type": "cppdbg",
      "request": "launch",
      "program": "${workspaceFolder}/build/${fileBasenameNoExtension}", // 指向 build 中的可執(zhí)行文件
      "args": [],                           // 可選參數，留空
      "stopAtEntry": false,                 // 是否在入口處停止
      "cwd": "${workspaceFolder}/build",    // 調試時的工作目錄
      "environment": [],                    // 環(huán)境變量
      "externalConsole": false,             // 使用內嵌終端
      "MIMode": "gdb",                      // 使用 gdb 調試
      "miDebuggerPath": "/usr/bin/gdb",     // gdb 路徑
      "setupCommands": [
        {
          "description": "Enable pretty-printing for gdb",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        }
      ]
    }
  ]
}

關鍵解釋