GDB & LLDB 调试 C/C++ 指南

文档概述

本文档完整、系统、详细介绍 GDB（GNU 调试器，Linux 首选） 和 LLDB（LLVM 调试器，macOS 首选） 调试 C/C++ 代码的全流程，包含完整命令、简写命令、功能说明、使用场景、实战案例，所有核心命令均以表格形式清晰呈现，适合新手入门、日常开发、问题排查。

适用平台：Linux（GDB）、macOS（GDB/LLDB）、WSL（GDB）

适用语言：C / C++

核心用途：崩溃排查、逻辑错误、变量异常、内存问题、多线程调试

---

一、调试前置：编译带调试符号的程序

所有调试必须先执行这一步！ 否则调试器无法识别代码行、变量、函数。

编译命令

# C 语言
gcc -g -O0 test.c -o test

# C++ 语言
g++ -g -O0 test.cpp -o test

# Clang 编译（LLDB 推荐）
clang -g -O0 test.c -o test

• -g：生成调试符号（必备）
• -O0：关闭编译器优化，保证调试精准

---

二、GDB 使用手册（Linux 主流）

1. GDB 启动方式

启动命令	功能
gdb ./test	调试可执行文件
gdb -p PID	附加到正在运行的进程
gdb ./test core.xxx	调试崩溃转储文件

---

2. GDB 命令表

（1）程序运行控制

完整命令	简写命令	功能说明
run	r	启动程序，运行到断点处停止
continue	c	从断点处继续运行程序
next	n	单步执行，不进入函数内部
step	s	单步执行，进入函数内部
finish	fin	执行完当前函数并跳出
until 行号	u 行号	直接运行到指定代码行
kill	k	终止当前调试的程序
quit	q	退出 GDB 调试器

---

（2）断点管理

完整命令	简写命令	功能说明
break 行号	b 行号	在当前文件指定行打断点
break 文件名:行号	b 文件名:行号	在指定文件的指定行打断点
break 函数名	b 函数名	在函数入口处打断点
break 行号 if 条件	b 行号 if 条件	条件断点（满足条件才触发）
info breakpoints	i b	查看所有断点
delete 断点编号	d 编号	删除指定编号断点
disable 断点编号	—	禁用断点（不删除）
enable 断点编号	—	启用断点
clear 行号	—	删除指定行的断点

---

（3）变量 & 内存查看

完整命令	简写命令	功能说明
print 变量	p 变量	打印变量值
print *指针	p *指针	打印指针指向的数据
print 数组@长度	p arr@5	打印数组前 N 个元素
display 变量	—	每次单步自动打印变量
undisplay 编号	—	取消自动打印
set variable 变量=值	set var=值	运行时修改变量值
x/格式 地址	—	查看内存数据（x/nfu 格式）
info locals	—	查看当前函数所有局部变量
info args	—	查看当前函数参数

---

（4）堆栈追踪

完整命令	简写命令	功能说明
backtrace	bt	查看函数调用堆栈
frame 编号	f 编号	切换到指定堆栈帧
up	—	切换到上一层堆栈
down	—	切换到下一层堆栈

---

（5）高级调试

完整命令	简写命令	功能说明
list	l	显示当前代码上下文
list 函数名	l 函数	查看指定函数代码
watch 变量	—	数据断点（变量被修改时暂停）
info threads	—	查看所有线程
thread 编号	—	切换到指定线程
disassemble	—	查看汇编代码

---

三、LLDB 使用手册（macOS 原生）

LLDB 是 macOS /iOS 开发默认调试器，语法与 GDB 高度兼容，支持 GDB 简写命令，同时拥有更规范的完整命令。

1. LLDB 启动方式

启动命令	功能
lldb ./test	调试可执行文件
lldb -p PID	附加到运行中进程

---

2. LLDB 命令表

（1）程序运行控制

完整命令	简写命令	功能说明
run	r	启动程序
continue	c	继续运行
next	n	单步跳过（不进函数）
step	s	单步进入（进函数）
finish	fin	跳出当前函数
until 行号	u 行号	运行到指定行
quit	q	退出 LLDB

---

（2）断点管理

完整命令	简写命令	功能说明
breakpoint set --line 行号	b 行号	在当前行设置断点
breakpoint set --file 文件名 --line 行号	b 文件:行号	在指定文件行设置断点
breakpoint set --name 函数名	b 函数名	在函数入口打断点
breakpoint set --line 行号 --condition 条件	b 行号 if 条件	条件断点
breakpoint list	—	查看所有断点
breakpoint delete 编号	—	删除断点
breakpoint disable 编号	—	禁用断点
breakpoint enable 编号	—	启用断点

---

（3）变量 & 内存查看

完整命令	简写命令	功能说明
print 变量	p 变量	打印变量
expression 变量=值	expr var=值	运行时修改变量
frame variable	fr v	查看所有局部变量
memory read 地址	memory read &var	查看内存数据
watchpoint set variable 变量	—	数据断点（修改变量时暂停）

---

（4）堆栈追踪

完整命令	简写命令	功能说明
thread backtrace	bt	查看调用堆栈
frame select 编号	f 编号	切换堆栈帧
up	—	上一层堆栈
down	—	下一层堆栈

---

（5）高级调试

完整命令	简写命令	功能说明
list	l	显示源代码
thread list	—	查看所有线程
thread select 编号	—	切换线程
disassemble	—	查看汇编

---

四、GDB vs LLDB 命令对照表

功能	GDB 完整命令	GDB 简写	LLDB 完整命令	LLDB 简写
运行程序	run	r	run	r
继续运行	continue	c	continue	c
单步跳过	next	n	next	n
单步进入	step	s	step	s
跳出函数	finish	fin	finish	fin
运行到行	until 行号	u	until 行号	u
行断点	break 行号	b	break set --line	b
函数断点	break 函数	b	break set -n	b
查看断点	info break	i b	break list	—
删除断点	delete	d	break delete	—
打印变量	print	p	print	p
修改变量	set var=值	—	expr var=值	—
查看堆栈	backtrace	bt	thread backtrace	bt
切换堆栈	frame 编号	f	frame select	f
查看局部变量	info locals	—	frame variable	fr v
数据断点	watch 变量	—	watchpoint set	—
退出	quit	q	quit	q

---

五、调试实战

1. 编译

gcc -g test.c -o test

2. 启动调试器

gdb ./test
# 或
lldb ./test

3. 打断点

b main
b 15

4. 运行程序

r

5. 调试

n  # 单步跳过
s  # 单步步入
p 变量  # 查看值
bt  # 查崩溃
c  # 继续运行

6. 退出

q

---

六、排查崩溃（Segmentation fault）

1. 编译加 -g
2. 运行调试器
3. 程序崩溃后输入：

bt

即可直接定位崩溃代码行。

---