从调试小白到高手：GDB调试工具完全指南

当你写的程序运行崩溃却找不到原因，当循环结果始终不对却查不出逻辑错误，当函数调用关系复杂到理不清——此时，一款强大的调试工具就是你的“救命稻草”。GDB（GNU Debugger）作为Linux下最常用的程序调试工具，能帮你精准定位问题、追踪变量变化、理清执行流程。本文将从基础到进阶，带你彻底掌握GDB的使用。

一、调试的前提：Debug模式 vs Release模式

在开始使用GDB前，必须先明确一个核心概念：程序能被调试的前提是“Debug模式”。

软件发布有两种模式：

• Release模式：编译时不包含调试信息，可执行文件体积小、运行效率高，适合最终上线发布。
• Debug模式：编译时包含详细的调试信息（如变量位置、代码行号映射等），可执行文件体积较大，但能被GDB识别并调试。

如何切换模式？

通过编译器（gcc/g++）的-g选项控制：

# 编译为Debug模式（包含调试信息，可被GDB调试）
gcc test.c -o test_debug -g

# 编译为Release模式（不包含调试信息，无法被GDB调试）
gcc test.c -o test_release

对比两种模式的可执行文件：

• Debug模式的文件体积更大（包含调试信息）；
• Release模式的文件体积更小（仅保留运行必需的代码）。

记住：GDB只能调试带有调试信息的可执行文件，即必须用-g选项编译的程序。

二、GDB快速入门：从启动到基本操作

1. 准备工作

首先创建一个测试目录并编写示例代码（以C语言为例）：

# 创建目录并进入
mkdir gdb_demo && cd gdb_demo

# 编写示例代码（sum.c）
cat > sum.c << EOF
#include <stdio.h>

int Sum(int s, int e) {
    int result = 0;
    for (int i = s; i <= e; i++) {
        result += i;
    }
    return result;
}

int main() {
    printf("开始计算...\n");
    int n = Sum(1, 100);
    printf("1到100的和为：%d\n", n);
    return 0;
}
EOF

# 编译为Debug模式
gcc sum.c -o sum_debug -g

2. 启动GDB

通过以下命令启动GDB并加载待调试程序：

gdb ./sum_debug

启动后会进入GDB交互界面，提示符为(gdb)，此时可输入各种调试命令。

3. 核心基础命令

（1）查看代码：list（简写l）

• 查看当前文件代码：l（默认显示10行，回车可继续显示后续内容）；
• 从指定行开始显示：l 行号（如l 5显示第5行及附近代码）；
• 查看指定文件代码：l 文件名:行号（多文件项目时用，如l sum.c:3）。

示例：

(gdb) l 1  # 从第1行开始显示代码
1   #include <stdio.h>
2   
3   int Sum(int s, int e) {
4       int result = 0;
5       for (int i = s; i <= e; i++) {
6           result += i;
7       }
8       return result;
9   }
10  

（2）设置断点：break（简写b）

断点是调试的核心，程序运行到断点处会暂停，方便查看状态。设置方式：

• 按行号：b 行号（如b 6在第6行设断点）；
• 按函数名：b 函数名（如b Sum在Sum函数入口设断点）；
• 按文件+行号/函数：b 文件名:行号（多文件时用，如b sum.c:5）。

示例：

(gdb) b 6  # 在第6行设置断点
Breakpoint 1 at 0x40052c: file sum.c, line 6.

(gdb) b Sum  # 在Sum函数入口设置断点
Breakpoint 2 at 0x40051d: file sum.c, line 4.

（3）查看断点：info break（简写info b）

查看所有已设置的断点信息（编号、位置、状态等）：

(gdb) info b
Num     Type           Disp Enb Address            What
1       breakpoint     keep y   0x000000000040052c in Sum at sum.c:6
2       breakpoint     keep y   0x000000000040051d in Sum at sum.c:4

• Num：断点编号（用于删除/修改断点）；
• Enb：是否启用（y启用，n禁用）。

（4）运行程序：run（简写r）

启动程序，程序会运行到第一个断点处暂停：

(gdb) r
Starting program: /root/gdb_demo/sum_debug 
开始计算...

Breakpoint 2, Sum (s=1, e=100) at sum.c:4
4       int result = 0;

（5）单步执行：next（简写n）与step（简写s）

程序暂停后，需要逐行执行查看流程：

• n（next，逐过程）：执行当前行，若当前行是函数调用，不进入函数内部；
• s（step，逐语句）：执行当前行，若当前行是函数调用，进入函数内部。

示例（在Sum函数内单步执行）：

# 停在Sum函数第4行时，用n执行下一行
(gdb) n
5       for (int i = s; i <= e; i++) {

# 再用n执行循环体第一行
(gdb) n
6           result += i;

（6）继续运行：continue（简写c）

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

(gdb) c
Continuing.

Breakpoint 1, Sum (s=1, e=100) at sum.c:6
6           result += i;  # 运行到下一个断点（第6行）

（7）删除断点：delete（简写d）

通过断点编号删除指定断点：

(gdb) d 2  # 删除编号为2的断点
(gdb) info b  # 确认删除
Num     Type           Disp Enb Address            What
1       breakpoint     keep y   0x000000000040052c in Sum at sum.c:6

（8）退出GDB：quit（简写q）

(gdb) q
A debugging session is active.
Do you really want to quit? (y or n) y

三、提升效率：使用cgdb优化调试体验

GDB默认是纯命令行界面，查看代码和输入命令需要频繁切换。cgdb是一款基于GDB的增强工具，支持分屏显示（上半部分代码，下半部分命令），操作更直观。

1. 安装cgdb

# Ubuntu
sudo apt-get install -y cgdb

# CentOS
sudo yum install -y cgdb

2. 使用cgdb

启动方式与GDB类似，直接加载可执行文件：

cgdb ./sum_debug

3. cgdb核心操作

• 分屏切换：按Esc进入代码屏（可用上下键翻阅代码），按i回到命令屏（输入GDB命令）；
• 快捷键：支持GDB所有命令，额外增加代码浏览功能（如Ctrl+f向下翻页，Ctrl+b向上翻页）。

四、进阶技巧：精准定位问题的核心能力

掌握基础操作后，这些进阶技巧能帮你更快定位问题：

1. 查看变量值：print（简写p）

临时查看变量或表达式的值：

# 在Sum函数内，查看result的值
(gdb) p result
$1 = 0  # 初始值为0

# 执行一次result += i后，再查看
(gdb) n  # 执行result += i（i=1）
(gdb) p result
$2 = 1  # 已更新为1

# 甚至可以计算表达式
(gdb) p i * 2 + result
$3 = 3  # i=1时，1*2+1=3

2. 自动监视变量：display与undisplay

若需要持续跟踪某个变量（每次执行后自动显示），用display：

# 监视i和result的值
(gdb) display i
1: i = 1
(gdb) display result
2: result = 1

# 执行下一行后，自动显示最新值
(gdb) n
6           result += i;
2: result = 1
1: i = 1

# 取消监视（通过编号）
(gdb) undisplay 1  # 取消监视i

3. 查看函数内所有局部变量：info locals

快速查看当前函数内定义的所有局部变量及其值：

(gdb) info locals
i = 3
result = 6  # 此时i=3，result=1+2+3=6

4. 监视变量变化：watch

当变量值发生变化时，自动暂停程序并提示（适合追踪变量异常修改）：

# 监视result，当它的值变化时暂停
(gdb) watch result
Hardware watchpoint 3: result

# 继续执行，当result变化时会触发暂停
(gdb) c
Hardware watchpoint 3: result

Old value = 6
New value = 10  # result从6变为10时暂停
Sum (s=1, e=100) at sum.c:5
5       for (int i = s; i <= e; i++) {

5. 临时修改变量值：set var

调试时发现变量值错误，可临时修改变量值验证是否解决问题：

# 假设循环变量i错误地从2开始，手动改回1
(gdb) p i
$4 = 2
(gdb) set var i = 1  # 修改i的值为1
(gdb) p i
$5 = 1

6. 条件断点：break ... if 条件

仅当满足特定条件时，断点才生效（适合循环中定位特定场景）：

# 在第6行设置断点，但仅当i=10时暂停
(gdb) b 6 if i == 10
Breakpoint 4 at 0x40052c: file sum.c, line 6.

# 运行后，只有当i=10时才会暂停
(gdb) r
...
Breakpoint 4, Sum (s=1, e=100) at sum.c:6
6           result += i;
(gdb) p i
$6 = 10  # 确实在i=10时暂停

📌 注意：
• 条件断点添加常见两种方式：1. 新增 2. 给已有断点追加
• 注意两者的语法有区别，不要写错了。
• 新增： b 行号/文件名:行号/函数名 if i == 30(条件)
• 给已有断点追加：condition 2 i==30， 其中2是已有断点编号，没有if

7. 函数调用栈跟踪：backtrace（简写bt）

当程序进入多层函数调用时，用bt查看调用链（从当前函数回溯到main函数）：

(gdb) bt
#0  Sum (s=1, e=100) at sum.c:6
#1  0x0000000000400586 in main () at sum.c:13
# 表示：当前在Sum函数（#0），由main函数第13行调用（#1）

8. 断点启用/禁用：enable与disable

暂时不需要某个断点但想保留（避免重复设置），可禁用它：

# 禁用编号为1的断点
(gdb) disable 1
(gdb) info b
Num     Type           Disp Enb Address            What
1       breakpoint     keep n   0x000000000040052c in Sum at sum.c:6  # Enb变为n

# 重新启用
(gdb) enable 1
(gdb) info b
1       breakpoint     keep y   0x000000000040052c in Sum at sum.c:6  # Enb变回y

五、调试的本质：从“猜问题”到“定位问题”

调试的核心不是机械地使用命令，而是通过工具精准定位问题根源：

1. 划分范围：用断点将程序划分为多个块，通过“运行到断点是否崩溃”缩小问题范围；
2. 验证假设：用p/info locals查看变量值，验证“是否符合预期”；
3. 追踪变化：用watch/display跟踪变量异常变化，找到修改源头；
4. 快速验证：用set var临时修改值，验证“修正后是否解决问题”。

六、总结

GDB作为Linux下的调试利器，看似命令繁多，实则核心逻辑清晰：通过断点控制程序执行节奏，通过变量查看/监视追踪数据变化，最终定位并解决问题。从l/b/r等基础命令，到watch/display/条件断点等进阶技巧，熟练掌握后能极大提升调试效率。

记住：调试的关键不是工具本身，而是“分步骤缩小问题范围”的思维。多实践、多思考，你会发现曾经头疼的bug，用GDB总能轻松破解。