Ubuntu 环境下的 C/C++ 编译与调试配置方法-牛翰网

统一管理输出文件：将所有编译生成的可执行文件统一存放到项目的 build 目录。
优化调试流程：调试器自动定位 build 中的可执行文件，免去手动调整路径的麻烦。
跨平台兼容性：确保配置适用于 Ubuntu 和其他类 Unix 系统。

前提条件

在开始之前，请确保系统已安装以下工具：

g++ 编译器
安装命令：

sudo apt install g++

gdb 调试器
安装命令：

sudo apt install gdb

VS Code 扩展：

C/C++ 插件（Microsoft 提供）：在扩展市场中搜索 “C/C++” 并安装。

创建项目目录结构

建议项目目录结构如下：

project-root/
├── build/           # 编译生成的可执行文件目录
├── src/             # 源代码文件目录
│   ├── main.cpp     # 示例源代码文件
├── tasks.json       # VS Code 任务配置文件
└── launch.json      # VS Code 调试配置文件

执行以下命令创建目录结构：

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

将你的源代码放入 src 目录，例如创建一个简单的 main.cpp：

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

配置 tasks.json 文件路径

将 tasks.json 保存到项目目录下的 .vscode 文件夹中。如果文件夹不存在，使用以下命令创建：

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 中的可执行文件
      "args": [],                           // 可选参数，留空
      "stopAtEntry": false,                 // 是否在入口处停止
      "cwd": "${workspaceFolder}/build",    // 调试时的工作目录
      "environment": [],                    // 环境变量
      "externalConsole": false,             // 使用内嵌终端
      "MIMode": "gdb",                      // 使用 gdb 调试
      "miDebuggerPath": "/usr/bin/gdb",     // gdb 路径
      "setupCommands": [
        {
          "description": "Enable pretty-printing for gdb",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        }
      ]
    }
  ]
}

关键解释