如何在Ubuntu上进行C++调试

在Ubuntu上进行C++调试，其实选择比想象中要丰富。既可以走命令行路线，靠GDB一把梭，也可以借助图形化工具，比如Visual Studio Code或CLion，让调试过程更直观。下面把两种方式都拆开来讲，外加一些实用技巧，希望对你有帮助。

一、准备工作：安装必要工具

调试的第一步，肯定是先把调试工具装好。在Linux环境下，GDB（GNU调试器）是当之无愧的核心工具。打开终端，敲下这行命令：

sudo apt update && sudo apt install gdb

装完之后，顺手用gdb --version确认一下，能正常显示版本号就说明搞定了。

二、编译时添加调试信息

这个步骤很容易被忽略，但很重要：为了让调试工具认得你的源代码——比如变量名、行号这些信息——编译时必须加上-g选项。举个例子：

g++ -g -o my_program my_program.cpp

几个关键选项说明一下：

• -g：把调试信息嵌入到可执行文件里，这一步必不可少；
• -O0：关闭编译器优化。为什么要关？因为优化后代码逻辑和源码可能对不上，比如循环变量被优化消失，调试时容易抓瞎；
• -Wall：开启所有警告，能把一些隐藏问题提前揪出来。

三、使用GDB进行命令行调试

GDB用熟了之后，其实效率极高。下面梳理一下最常用的操作流程。

1. 启动GDB

在终端里输入：

gdb ./my_program

之后你会进入一个交互界面，提示符变成(gdb)，所有命令都在这下面执行。

2. 常用调试命令

• 设置断点：可以让程序在指定位置暂停。比如：

  break main          # 在main函数入口处打断点
  break my_program.cpp:42  # 在第42行打断点

• 运行程序：遇到断点就会停下来：

  run   # 简写为 r

• 单步执行，两种模式：

  • next（简写n）：执行下一行，不进入函数内部；
  • step（简写s）：执行下一行，但会钻进函数里，适合跟踪复杂逻辑。

• 查看变量：举个例子，想看变量i的值：

  print i   # 简写为 p i

• 查看调用栈：当程序崩溃时，这个命令能帮你迅速定位问题：

  backtrace   # 简写为 bt

• 继续执行：从当前断点继续跑，直到下一个断点或程序结束：

  continue   # 简写为 c

• 退出GDB：

  quit   # 简写为 q

四、使用Visual Studio Code（VS Code）进行图形化调试

对于不习惯命令行的朋友，VS Code是一个非常好的选择，轻量且功能强大，通过安装扩展就能获得直观的调试体验。

1. 安装必要组件

从官网下载并安装VS Code后，打开它，按Ctrl+Shift+X进入扩展商店，搜索并安装由Microsoft发布的C/C++扩展。

2. 配置调试环境

需要在项目根目录下创建一个.vscode文件夹，并添加两个配置文件：

• tasks.json：定义编译任务，生成带调试信息的可执行文件。

  {
      "version": "2.0.0",
      "tasks": [
          {
              "label": "build",
              "type": "shell",
              "command": "g++",
              "args": [
                  "-g",
                  "-O0",
                  "-Wall",
                  "${file}",
                  "-o",
                  "${fileDirname}/${fileBasenameNoExtension}"
              ],
              "group": {
                  "kind": "build",
                  "isDefault": true
              }
          }
      ]
  }

• launch.json：配置调试器，把VS Code和GDB串起来。

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "C++ Debug",
              "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": "build"
          }
      ]
  }

  注意，preLaunchTask的值要跟tasks.json里的label保持一致，这样调试前会自动编译。

3. 启动调试

打开你要调试的C++文件（比如my_program.cpp），在行号左侧点击设置断点——会出现一个红点。然后按下F5或者点击顶部工具栏的绿色调试箭头，就可以开始调试了。调试工具栏上有继续、单步跳过、单步进入等按钮，变量面板里能看到当前所有变量的值，非常直观。

五、其他实用调试工具

除了GDB和VS Code，还有几个工具在特定场景下非常好用。

• Valgrind：专门用来检测内存泄漏和非法内存访问。使用方法：

  valgrind --leak-check=full ./my_program

  输出结果会清楚地告诉你哪里泄露了多少内存。

• strace：追踪程序的系统调用，比如它访问了什么文件、发起了什么网络请求。命令很简单：

  strace ./my_program

• AddressSanitizer：一个编译器层面的工具，检测内存错误非常快。编译时加上-fsanitize=address：

  g++ -g -fsanitize=address -O0 -o my_program my_program.cpp

  运行程序后，如果有缓冲区溢出或use-after-free等问题，AddressSanitizer会直接输出详细的错误信息。

六、调试技巧

最后分享几个实战中很管用的技巧：

• 程序崩溃时，第一时间用backtrace看调用栈，能快速定位到出问题的函数；
• 用watch variable_name监视某个变量，当它的值发生变化时程序会自动暂停，这在排查变量被意外修改的场景里特别好用；
• 记得加-O0，避免编译器优化带来的干扰；
• 在代码里多用assert(condition)，条件不满足时会直接终止程序并报错，能帮你尽早发现逻辑错误。如果正式发布时想去掉断言，编译时加上-DNDEBUG宏就行。