gdb调试新手入门教程

入门与上手

面向刚接触调试的开发者,讲清 GDB 常用命令、编译前提和入门调试流程,给一套能直接照着敲的排查顺序。

写 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 后面跟参数。不想每次都手敲参数,也可以写进配置文件或者用启动脚本带出来,具体写法去站内工具目录找现成的对照说明。

  1. 进调试器把可执行文件路径作为参数启动 gdb;确认提示符出现,说明加载成功。
  2. 下断点三种下法:按函数名下、按「文件:行号」下、按条件下(命中某条件才停)。新手先用前两种,第三种等熟练了再上。
  3. 跑起来敲 run 让程序跑。如果带了命令行参数,就在 run 后面跟上;程序会停在第一个命中的断点处。
  4. 停下来看三样按顺序看:当前行、附近源码、关键变量的值。不确定变量类型时先看变量本身,再看它指向的内容。
  5. 单步走单步有两种粒度:逐语句步入函数、逐过程跳过函数调用。卡在标准库或第三方库里时用后者,别一头扎进去出不来。

判断自己走对了没有,看一个信号:每按一次单步,光标的行号和屏幕上的源码应该能对上;如果对不上,八成是没带调试信息或者开了优化,回到上一节处理。

崩了怎么查:一套固定的排查顺序

崩溃排查最怕东敲一条西敲一条。下面这个顺序是固定的,从上到下走,每一步只解决一个问题。走完还没找到原因,再回头怀疑是不是复现路径不对。

  • 第一步看调用栈,确认是「谁调用了出错的函数」,栈顶往往只是一个表现,真正的错常在上一两层;
  • 第二步切到出错的那一层,看当时各个参数和局部变量,重点是空指针、越界下标、已释放对象这三类;
  • 第三步做对照实验:把可疑变量的值打印出来,或者临时把某段逻辑跳过,确认是不是它导致的;
  • 第四步复现验证:找到原因后重跑一遍同样的输入路径,确认停在同一个位置、值也对得上,再动手改代码。
栈里看到的信号通常意味着下一步动作
栈顶是库函数,上一两层是自己的代码错误从你的调用传进去的切到自己的那一层看参数
参数是个可疑的空值或越界下标空指针或越界访问打印该变量和它的上下界确认
对象指针看着正常但内容已失效对象已被释放还在用确认生命周期,找谁先释放的
换一组输入就不复现跟特定数据有关固定输入路径再跑一次

几个新手容易忽略的习惯

命令会敲了,习惯不对照样浪费时间。下面这几条不是语法问题,是排查节奏问题:断点管理、会话保存、多线程处理,以及一个最容易踩的坑——把调试器里的状态当成最终结论。

断点越加越多
调试完记得清掉,不然下次跑起来先停在一个你早就忘了的地方
会话中途退出
断点和历史会丢,长一点的排查用批处理脚本,或者在配置文件里预置常用命令
多线程程序
默认只停当前线程,切线程和看各线程栈是单独动作,别看到一半栈就下结论
调试与验证
调试只是定位手段,不是验证手段,改完代码要用正常方式重新跑一遍

顺手补一点工具链常识:不同编译器、不同平台的调试信息格式和命令细节有差异,本文给的是通用顺序,具体到你的环境里以实测为准。想横向了解可用的调试与诊断工具、以及哪些值得花时间学,去站内的工具目录翻一翻对照。至于各家云服务和 API 的报价,本站只做资料整理,具体数字到站内价格追踪页面核对当时的数值即可。

下一步把本文这套顺序存成自己的排查清单;再去工具目录看还有哪些调试与诊断工具值得备着,以及价格追踪页里当前各组件的报价口径。

常见问题

GDB 和 IDE 里那个调试按钮,我该学哪个?

两者底层是一回事,IDE 的图形调试界面多数就是把 GDB 包了一层。日常点按钮更快,但要学的是「断点、单步、看栈、看变量」这套思路,换到服务器、容器、只给终端的机器上就是命令行的活。先把 IDE 用熟也行,只是别只会点按钮,遇到装不了图形界面的环境就卡住。

为什么我下了断点,程序根本没停?

先按这个顺序查:断点下在的函数有没有真的被调用;编译时有没有带调试信息、优化等级是不是太高导致那一行被合并或删掉;断点下在哪个文件,是不是和实际加载的不是同一份。除此之外,多进程、fork 之后子进程、被动态加载的库,都需要单独设置才能停住。

程序不崩,只是结果不对,GDB 还有用吗?

有用,而且这类问题更该用调试器。崩了至少有明确的停点,结果不对没有,得自己挑停点:在算出错误结果的那段代码前下断点,沿着数据从输入到输出一段段看什么时候值开始不对。比到处加打印省事的地方在于,改看哪个变量不用重新编译。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。