写 C/C++ 时最常见的一幕:程序崩了或者结果不对,加一堆 printf 重新编译,来回猜半天还是不知道哪一步出了问题。这篇不讲原理,只给一条能照着敲的路径:怎么让程序带上调试信息、怎么断在某一行、怎么单步走、怎么看变量和调用栈,以及卡住时按什么顺序排查。适合刚学完指针和数组、还没正经用过调试器的人。
写 C/C++ 时最常见的一幕:程序崩了或者结果不对,加一堆 printf 重新编译,来回猜半天还是不知道哪一步出了问题。这篇不讲原理,只给一条能照着敲的路径:怎么让程序带上调试信息、怎么断在某一行、怎么单步走、怎么看变量和调用栈,以及卡住时按什么顺序排查。
适合刚学完指针和数组、还没正经用过调试器的人。全程按顺序来,每一步都能自己验证有没有做对。调试器只是一个能让你停下来看现场的工具,真正解决问题靠的是你观察到的数字和调用关系。
先把程序编成能调试的样子,再谈调试
新手第一次用 GDB 失败,绝大多数不是命令敲错了,而是二进制文件里根本没有调试信息。编译时要把调试开关打开、同时把优化关掉,否则断点会跳到别的行、局部变量会被优化掉,你看到的现场和源码对不上,越调越糊涂。
- 编译时加调试信息并关优化在编译命令里同时打开调试信息开关、把优化等级设成不优化。写 Makefile 的项目要确认最终链接出来的那份也是这么编的,别只改了其中一个目标。
- 确认可执行文件里真的有调试段用 readelf 或 objdump 之类工具看一眼有没有调试相关段。看不到就说明编译参数没生效,回去检查是不是被构建脚本覆盖了。
- 选择启动方式普通小工具直接让 GDB 加载可执行文件启动;如果是常驻服务,先让它跑起来,再用 GDB 按进程号挂上去,这样不会因为调试器启动顺序改变现场。
- 确认能进能出进去后先看帮助、再正常退出。卡在交互界面里出不来不算会调试,把退出和帮助这两条命令先敲熟。
- 调试信息
- 编译时额外写进可执行文件的一段数据,告诉调试器某段机器指令对应源码的哪一行、哪个变量放在哪。
- 优化等级
- 编译器做代码变换的激进程度,等级越高越会把变量塞进寄存器或直接删掉,导致调试时看不到值。
- 挂载进程
- 让调试器附到一个已经在运行的进程上,适合不方便重启的服务类程序。
断点、单步、继续:跑起来之后的三板斧
程序跑起来以后你只有三种基本动作:断在某处、一步一步走、直接放行到下一个断点。把这三件事拆开练,比一次性背一堆命令有用。断点要落得准,单步要分得清「进函数」和「当一步」,继续要能配合断点控制节奏。
| 你要做的事 | 常见落点 | 注意事项 |
|---|---|---|
| 按函数停下 | 函数名 | 同名重载或同名静态函数要看清停的是哪一个 |
| 按位置停下 | 文件名 + 行号 | 头文件里的行号会被多处引用,可能一次命中多个位置 |
| 条件停下 | 位置 + 条件表达式 | 循环里只关心某一次时用它,条件写错会一直不停 |
| 放行 | 继续命令 | 别把断点越积越多,否则每次启动都要手动放行很多次 |
| 走一步 | 逐语句 / 逐过程 | 逐语句会钻进函数,逐过程把整个调用当一步 |
- 单步分两档:逐语句进到被调用函数里,逐过程把这一行整个执行完。分不清就容易掉进标准库或第三方库里出不来,这时候用跳出命令回到上层。
- 临时断点适合只停一次的场景,停完自动删掉,比手动删干净。
- 查看周围代码、列出当前所有断点、删除指定断点是配套动作,三个配合才能保证你清楚下一步会停在哪。
- 条件断点里不要写有副作用的表达式,调试器求值可能改变程序状态,看到的现象就不是原样了。
单步走不动的常见原因
如果在某个函数里怎么走都出不来,通常是你钻进了一个没有调试信息的大库函数,或者走进了一个死循环。前者直接执行到当前函数的返回位置跳出来,后者先看循环条件里的变量怎么变,再在循环体里加条件断点缩小范围。
看到变量和调用栈,才算找到问题
停下来的那一行本身不一定有问题,真正有用的信息往往是「是谁把它变成这样的」。所以看变量的同时一定要看调用栈:当前帧是你停住的地方,往上一层是调用它的函数,再往上是更外层的调用者。
- 打印变量和表达式是最基本的动作,注意作用域——没进到某个函数时,它的局部变量是看不到的。
- 调用栈从当前帧往上翻,哪一层传进来的参数不对,往往比崩溃那一行更有价值。
- 切换栈帧可以回到上层看当时的取值,配合打印上层的入参,能判断是调用方传错还是被调用方算错。
- 数组、结构体、指针要看清楚类型和地址,指针地址明显不属于任何合理区域时,先怀疑解引用和越界,而不是编译器。
崩溃那一行只是结果,第一次出现异常值的那一层才是原因。
崩溃现场:按固定顺序看一遍
崩溃最容易让人慌,但只要按固定顺序走一遍,信息是够用的。先确认是哪种停止方式,再看现场的值,然后往上翻栈找第一次异常,最后才动手缩小复现范围。顺序反了就会一直在崩溃行附近打转。
- 先看停在哪、以什么方式停的段错误、断言失败、收到信号,这几类排查方向不一样。段错误重点看内存访问,断言重点看被断言的条件。
- 再看这一行的变量取值尤其盯住指针、下标、容量这几个数字,看下标有没有超出容量、指针有没有越界或为空。
- 往上翻栈找第一次异常不要停在最后崩的那一帧,往上走,找第一次出现不合理值的那一层。
- 缩小复现范围二分注释掉一部分代码、把复现步骤压到最短、给可疑的循环加条件断点,让问题在小样本上稳定重现。
具体某个信号或错误码在不同平台上的表现会有差别,排查细节可以到 站内指南中心(/guides) 看整理好的那几篇,按当时的系统环境对照着查,别照着旧结论硬套。
练手方式与几个高频坑
调试是手上功夫,看十篇教程不如自己造一个错。建议刻意写一个越界访问、一个空指针解引用、一个循环边界写错的小程序,把整条流程走完。走完一遍你会发现,真正花时间的不是敲命令,而是想清楚该在哪停、该看哪个值。
| 高频坑 | 现象 | 怎么处理 |
|---|---|---|
| 没带调试信息 | 断点位置和源码对不上,变量看不到 | 回去改编译参数,重新构建 |
| 开了优化 | 断点跳行、变量显示被优化掉 | 关优化重编,再复现一次 |
| 断点打在头文件 | 同一次运行命中很多处 | 改到具体的源文件行号上 |
| 多线程下不停在想停的线程 | 程序一会儿停一会儿不停 | 先切到目标线程再操作,或者用条件把范围限住 |
| 只盯崩溃那一行 | 改了半天还是同一个错 | 往上翻栈,找第一次值变错的那一层 |
- 什么时候不该用 GDB:纯输入输出的逻辑错误,用小样本输入加几行打印更快;界面程序或大量异步回调的场景,换用日志和专门的工具更省事。
- 复现不了的问题,先固定住运行环境和输入,再谈调试;连稳定复现都做不到,任何调试器都帮不上忙。
- 每次调完把临时断点和临时打印清掉,否则它们会留在代码和调试脚本里,下次把别人也带沟里。
如果你还想知道主流编译器和调试工具各自的最新支持情况,可以到 站内模型与工具资料库(/models) 看整理好的条目;需要对比不同 API 服务当时的报价和可用性,到 价格追踪(/price-watch) 核对当时的数字,这类信息变化快,不要记死。
下一步把上面这套流程在自己的一个小程序上跑通一遍,再去看不同工具链和服务的对比信息,判断会清楚很多。→常见问题
为什么我打了断点却停不下来?
先查三件事:编译时有没有带调试信息、有没有开优化导致行号错位、断点打的位置是不是真的会被执行到。头文件里的函数常被多处包含,断点可能落在你不关心的那份代码里,换成文件名加行号再试。
GDB 和图形化调试器该学哪个?
看你的使用场景。在服务器、容器或者只有终端的环境里,GDB 是唯一能用的;本地写小项目,图形界面点鼠标确实更快。建议先过一遍 GDB 的命令流程,理解断点、单步、调用栈这几个概念,后面换任何工具都是同一套思路。
单步走下去还是找不到问题怎么办?
说明问题不在你走的那段路上。换个思路:先在最外层打条件断点,直接跳到出问题那次调用;或者二分注释代码,把范围压到几十行再细看。也可以先把复现步骤固定成最小输入,能稳定复现的问题基本都跑不掉。