GDB 超全详解教程：零基础入门到高阶调试-三亩地-编程学习日记

一、GDB 简介与核心作用

GDB（GNU Debugger）是 GNU 开源组织推出的跨平台、命令行式程序调试工具，支持 C/C++、Go、Rust 等主流编译型语言，可运行在 Linux、MacOS、类 Unix 系统，是后端开发、嵌入式开发、底层调试的核心工具。

相较于 IDE 图形化调试，GDB 轻量化、无依赖、可远程调试、支持内核级调试，能够实现：程序启动调试、断点调试、堆栈分析、变量监控、内存查看、异常捕获、进程附着调试等全场景调试能力，是排查段错误、死循环、内存越界、堆栈溢出等疑难问题的必备工具。

二、前置准备：编译带调试信息的程序

2.1 编译参数说明

GDB 只能调试带调试符号信息的程序，普通编译（gcc main.c -o main）会剥离调试信息，无法断点、查看源码。

核心编译参数：

-g：添加基础调试信息，支持源码级调试（最常用）
-ggdb：生成 GDB 专用调试信息，兼容性最好，推荐使用
-O0：关闭编译器优化（默认 O2/O3 优化会打乱代码执行顺序，导致调试错位）

标准编译命令：gcc main.c -o main -ggdb -O0

2.2 实战示例代码（全程调试使用）

编写main.c，包含循环、函数调用、数组越界、指针操作，覆盖绝大多数调试场景：

#include <stdio.h> #include <string.h> // 加法函数 int add(int a, int b) { int res = a + b; return res; } // 循环测试函数 void loop_test() { int arr[5] = {1,2,3,4,5}; // 故意制造数组越界（段错误隐患） for(int i = 0; i <= 5; i++) { arr[i] = i * 2; printf("arr[%d] = %d\n", i, arr[i]); } } int main(int argc, char *argv[]) { int x = 10; int y = 20; int sum = add(x, y); printf("sum = %d\n", sum); loop_test(); char str[4] = "abc"; char *p = str; printf("str = %s\n", p); return 0; }

编译命令：gcc main.c -o gdb_demo -ggdb -O0，生成可调试程序gdb_demo。

三、GDB 调试整体流程图

完整调试链路：启动 GDB → 配置参数 → 设置断点 → 运行程序 → 单步调试 → 查看变量/堆栈 → 动态修改变量 → 排查异常 → 退出调试

四、GDB 全量命令分类详解（含简写+示例）

本文将 GDB 所有常用命令按启动配置、断点管理、程序运行、单步调试、信息查看、堆栈分析、内存操作、动态修改、高级调试、退出配置十大类整理，全覆盖日常调试场景。

4.1 启动与基础配置命令

用于启动 GDB、配置程序运行参数、日志、工作环境。

完整命令	简写	功能说明	实操示例
gdb [程序名]	无	启动GDB，加载可执行程序	`gdb ./gdb_demo`
set args [参数]	无	设置程序命令行参数	`set args 100 test`
show args	无	查看已设置的命令行参数	`show args`
set verbose on/off	无	开启/关闭详细调试日志	`set verbose on`
directory [路径]	dir	添加源码搜索路径	`dir ./src`
help [命令]	h	查看命令帮助文档	`h break`
quit	q	退出GDB调试	`q`

4.2 断点管理命令（核心高频）

断点是调试核心，支持行断点、函数断点、条件断点、临时断点、观察断点（监控变量/内存变化）。

完整命令	简写	功能说明	实操示例
break [行号]	b	在指定行设置断点	`b 18`（18行断点）
break [函数名]	b	在函数入口设置断点	`b add`
break [文件:行号]	b	多文件项目指定文件断点	`b main.c:22`
break +n/-n	b	当前行前后n行断点	`b +3`
tbreak [位置]	tb	临时断点（触发1次后自动删除）	`tb loop_test`
break [位置] if [条件]	b	条件断点（满足条件才触发）	`b 25 if i==5`
watch [变量]	w	写观察断点（变量被修改触发）	`watch sum`
rwatch [变量]	rw	读观察断点（变量被读取触发）	`rw x`
awatch [变量]	aw	读写观察断点（读/改均触发）	`aw arr[i]`
info breakpoints	i b	查看所有断点列表	`i b`
delete [断点号]	d	删除指定断点，无参数删除全部	`d 1`/`d`
disable [断点号]	dis	禁用断点（保留不删除）	`dis 2`
enable [断点号]	ena	启用禁用的断点	`ena 2`

4.3 程序运行与继续命令

控制程序启动、暂停、重启、继续运行。

完整命令	简写	功能说明	实操示例
run	r	从头运行程序，触发断点暂停	`r`
continue	c	暂停后继续运行到下一个断点	`c`
start	无	启动程序，暂停在main函数第一行	`start`
kill	k	终止当前正在调试的程序	`k`
restart	rs	重启程序调试	`rs`

4.4 单步调试命令（逐行执行）

精准控制代码执行流程，区分进入函数和跳过函数，是逐行排错核心。

完整命令	简写	功能说明	适用场景
step	s	逐行执行，进入自定义函数内部	需要调试函数内部逻辑
next	n	逐行执行，跳过函数，不进入内部	确认函数无问题，快速跳过
finish	fin	执行完当前函数，跳出到函数调用处	误入无需调试的函数，快速退出
until	u	运行到指定行，或跳出循环体	跳出死循环、快速跑完循环

核心区别：s会进入函数，n直接执行完函数返回结果，不进入内部。

4.5 源码查看命令

调试过程中实时查看源码，无需退出 GDB。

命令	简写	功能	示例
list	l	查看当前行上下10行源码	`l`
list 行号	l	查看指定行附近源码	`l 20`
list 函数名	l	查看指定函数源码	`l add`
set listsize N	无	设置list显示行数	`set listsize 20`

4.6 变量与表达式查看命令

调试最常用命令，用于查看变量、数组、指针、表达式运算结果。

命令	简写	功能	示例
print [变量/表达式]	p	打印变量值、运算表达式	`p x`、`p x+y`
print /x 变量	p/x	十六进制打印	`p/x sum`
print /d 变量	p/d	十进制打印（默认）	`p/d x`
print /c 变量	p/c	字符格式打印	`p/c str[0]`
display [变量]	disp	每次暂停自动打印变量	`disp i`
undisplay [编号]	undisp	取消自动打印	`undisp 1`
info locals	i lo	查看当前函数所有局部变量	`i lo`
info args	i ar	查看当前函数参数	`i ar`

4.7 堆栈调试命令（排查崩溃核心）

程序段错误、崩溃时，通过堆栈查看函数调用链路，定位崩溃代码行。

命令	简写	功能	示例
backtrace	bt	查看完整堆栈调用链路	`bt`
bt N	bt N	只查看顶部N层堆栈	`bt 3`
frame [堆栈号]	f	切换到指定堆栈帧	`f 2`
up	无	切换到上一层堆栈	`up`
down	无	切换到下一层堆栈	`down`

4.8 内存与指针调试命令

查看内存数据、指针指向、数组内存，排查内存越界、野指针问题。

命令	功能说明	示例
x /[格式][长度] 地址	查看指定内存数据	`x/10dw p`查看指针p指向的10个int数据
print *指针	解引用指针，查看指向数据	`p *p`
info memory	查看程序内存布局	`info memory`

x命令格式详解：x/数量格式宽度地址

格式：d十进制、x十六进制、c字符、s字符串
宽度：b字节、w4字节、g8字节

4.9 动态修改变量与运行时修改

无需重新编译，实时修改变量值，快速验证逻辑。

命令	功能	示例
set 变量=值	修改变量值	`set x=100`
set ptr=地址	修改指针指向	`set p=str+1`

4.10 高阶调试命令

4.10.1 附着正在运行的进程

无需重启程序，调试正在后台运行的进程（排查死循环、卡死问题）。

# 1. 查看进程PID ps -ef | grep gdb_demo # 2. 附着进程 gdb attach 进程PID # 3. 调试完成后分离进程（不杀死进程） detach

4.10.2 核心转储文件调试（崩溃复盘）

程序崩溃生成 core 文件后，通过 GDB 复盘崩溃现场：

# 开启core文件生成 ulimit -c unlimited # 调试core文件 gdb ./gdb_demo core.xxx

4.10.3 日志与批量调试

save breakpoints 文件名：保存所有断点到文件
source 文件名：加载保存的断点配置
set logging on：开启GDB日志，保存调试过程

五、完整实战调试流程（手把手演示）

5.1 启动调试+设置断点

# 启动gdb gdb ./gdb_demo # 在add函数、loop_test函数设置断点 (gdb) b add (gdb) b loop_test # 查看断点 (gdb) i b # 运行程序 (gdb) r

5.2 逐行调试与变量查看

# 触发add函数断点，查看函数参数 (gdb) i ar # 单步执行 (gdb) s # 查看局部变量res (gdb) p res # 跳出当前函数 (gdb) fin # 继续运行到下一个断点 (gdb) c

5.3 条件断点排查数组越界

# 在循环行设置条件断点，i=5时暂停（越界位置） (gdb) b 25 if i==5 (gdb) c # 查看数组内存 (gdb) x/6dw arr # 修改变量规避错误，验证逻辑 (gdb) set i=4 # 继续运行 (gdb) c

5.4 堆栈崩溃排查演示

程序因数组越界触发段错误后：

# 查看崩溃堆栈 (gdb) bt # 切换到崩溃堆栈帧 (gdb) f 0 # 查看当前变量 (gdb) i lo

可精准定位到i=5时数组越界的问题。

六、高频问题与调试技巧

6.1 调试错位问题

现象：断点行和执行行不匹配，原因：编译器优化，解决方案：编译必须加-O0 -ggdb。

6.2 找不到源码问题

解决方案：使用dir 源码路径添加源码搜索目录。

6.3 重复调试快捷操作

回车：重复执行上一条命令
r：一键重启调试，无需退出GDB
保存断点：避免每次重启重新设置断点

GDB 调试核心逻辑可总结为：断点精准定位、单步逐行排查、变量实时监控、堆栈回溯溯源、动态修试验证。本文覆盖了 GDB 全部高频、高阶命令，搭配可直接运行的示例代码和完整调试流程，能够满足日常开发、嵌入式调试、崩溃排错等所有场景。

日记详情

GDB 超全详解教程：零基础入门到高阶调试