写 C/C++ 时程序崩了,终端只吐出一句 Segmentation fault,连哪一行出事都不知道——这时候多数人第一反应是到处插 printf,改一轮编译一轮,半天找不到问题。GDB 就是干这个的:让程序停在出事的地方,把当时的变量、调用栈、内存状态摊开给你看。这篇不堆命令手册,只讲新手最该先掌握的几步:编译要带什么参数、断点怎么下、崩了之后先敲哪条命令、卡住时按什么顺序查。
写 C/C++ 时程序崩了,终端只吐出一句 Segmentation fault,连哪一行出事都不知道。多数人第一反应是到处插 printf,改一轮编译一轮,半天找不到问题。GDB 就是干这个的:让程序停在出事的地方,把当时的变量、调用栈、内存状态摊开给你看。这篇不堆命令手册,只讲新手最该先掌握的几步。
下面按「编译怎么带参数 → 第一次跑起来怎么下断点 → 崩了按什么顺序查 → 哪些习惯别养成」走一遍。每一步都给能照着敲的动作,以及「怎么确认自己敲对了」。学会这套顺序,比背下几十条命令有用得多。
先让程序「可被调试」:编译期就要做的事
默认编译出的可执行文件会丢掉符号信息,GDB 只能看到一串地址,看不懂函数名和行号,等于戴着墨镜找东西。调试前先确认编译带了调试信息,并且把优化等级降下来,否则变量可能被优化掉、单步跳转和源码对不上,看到的行号会「乱跳」。
- 打开调试信息:编译时加上 -g 这类开关,具体名称按你的编译器文档确认;
- 优化等级先降到 -O0,排查性能相关问题时再单独开优化另说;
- 报错里带 Segmentation fault、Aborted、core dumped 这类字样,基本就是该上调试器,而不是继续加打印;
- 不想每次手动拼参数,去检查构建脚本或 Makefile 里有没有单独的 debug 目标,没有就自己加一个,把上面两个开关固定进去。
| 现象 | 大概率原因 | 先做什么 |
|---|---|---|
| 编译通过但 GDB 里只显示地址 | 没带调试信息 | 回去改编译参数,带上调试信息重编 |
| 单步时行号乱跳、变量显示被优化掉 | 开了优化 | 临时降到 -O0 重新编译 |
| 一跑就 Segmentation fault | 多半是空指针或越界 | 用调试器跑,按下一节的顺序看栈 |
| 不知道怎么写编译命令 | 构建脚本里没现成目标 | 在脚本里加一个 debug 目标,固定参数 |
第一次跑起来:进 GDB、下断点、单步看变量
启动方式记住一条就够:把可执行文件路径交给 gdb。需要命令行参数时,用 run 后面跟参数。不想每次都手敲参数,也可以写进配置文件或者用启动脚本带出来,具体写法去站内工具目录找现成的对照说明。
- 进调试器把可执行文件路径作为参数启动 gdb;确认提示符出现,说明加载成功。
- 下断点三种下法:按函数名下、按「文件:行号」下、按条件下(命中某条件才停)。新手先用前两种,第三种等熟练了再上。
- 跑起来敲 run 让程序跑。如果带了命令行参数,就在 run 后面跟上;程序会停在第一个命中的断点处。
- 停下来看三样按顺序看:当前行、附近源码、关键变量的值。不确定变量类型时先看变量本身,再看它指向的内容。
- 单步走单步有两种粒度:逐语句步入函数、逐过程跳过函数调用。卡在标准库或第三方库里时用后者,别一头扎进去出不来。
判断自己走对了没有,看一个信号:每按一次单步,光标的行号和屏幕上的源码应该能对上;如果对不上,八成是没带调试信息或者开了优化,回到上一节处理。
崩了怎么查:一套固定的排查顺序
崩溃排查最怕东敲一条西敲一条。下面这个顺序是固定的,从上到下走,每一步只解决一个问题。走完还没找到原因,再回头怀疑是不是复现路径不对。
- 第一步看调用栈,确认是「谁调用了出错的函数」,栈顶往往只是一个表现,真正的错常在上一两层;
- 第二步切到出错的那一层,看当时各个参数和局部变量,重点是空指针、越界下标、已释放对象这三类;
- 第三步做对照实验:把可疑变量的值打印出来,或者临时把某段逻辑跳过,确认是不是它导致的;
- 第四步复现验证:找到原因后重跑一遍同样的输入路径,确认停在同一个位置、值也对得上,再动手改代码。
| 栈里看到的信号 | 通常意味着 | 下一步动作 |
|---|---|---|
| 栈顶是库函数,上一两层是自己的代码 | 错误从你的调用传进去的 | 切到自己的那一层看参数 |
| 参数是个可疑的空值或越界下标 | 空指针或越界访问 | 打印该变量和它的上下界确认 |
| 对象指针看着正常但内容已失效 | 对象已被释放还在用 | 确认生命周期,找谁先释放的 |
| 换一组输入就不复现 | 跟特定数据有关 | 固定输入路径再跑一次 |
几个新手容易忽略的习惯
命令会敲了,习惯不对照样浪费时间。下面这几条不是语法问题,是排查节奏问题:断点管理、会话保存、多线程处理,以及一个最容易踩的坑——把调试器里的状态当成最终结论。
- 断点越加越多
- 调试完记得清掉,不然下次跑起来先停在一个你早就忘了的地方
- 会话中途退出
- 断点和历史会丢,长一点的排查用批处理脚本,或者在配置文件里预置常用命令
- 多线程程序
- 默认只停当前线程,切线程和看各线程栈是单独动作,别看到一半栈就下结论
- 调试与验证
- 调试只是定位手段,不是验证手段,改完代码要用正常方式重新跑一遍
顺手补一点工具链常识:不同编译器、不同平台的调试信息格式和命令细节有差异,本文给的是通用顺序,具体到你的环境里以实测为准。想横向了解可用的调试与诊断工具、以及哪些值得花时间学,去站内的工具目录翻一翻对照。至于各家云服务和 API 的报价,本站只做资料整理,具体数字到站内价格追踪页面核对当时的数值即可。
下一步把本文这套顺序存成自己的排查清单;再去工具目录看还有哪些调试与诊断工具值得备着,以及价格追踪页里当前各组件的报价口径。→常见问题
GDB 和 IDE 里那个调试按钮,我该学哪个?
两者底层是一回事,IDE 的图形调试界面多数就是把 GDB 包了一层。日常点按钮更快,但要学的是「断点、单步、看栈、看变量」这套思路,换到服务器、容器、只给终端的机器上就是命令行的活。先把 IDE 用熟也行,只是别只会点按钮,遇到装不了图形界面的环境就卡住。
为什么我下了断点,程序根本没停?
先按这个顺序查:断点下在的函数有没有真的被调用;编译时有没有带调试信息、优化等级是不是太高导致那一行被合并或删掉;断点下在哪个文件,是不是和实际加载的不是同一份。除此之外,多进程、fork 之后子进程、被动态加载的库,都需要单独设置才能停住。
程序不崩,只是结果不对,GDB 还有用吗?
有用,而且这类问题更该用调试器。崩了至少有明确的停点,结果不对没有,得自己挑停点:在算出错误结果的那段代码前下断点,沿着数据从输入到输出一段段看什么时候值开始不对。比到处加打印省事的地方在于,改看哪个变量不用重新编译。