gdb 调试入门

入门与上手

给 C/C++ 初学者讲清 GDB 调试的常用命令与基本流程,从编译带符号、下断点到看栈查变量,一步步能自己走完。

写 C/C++ 时最常见的一幕:程序崩了或者结果不对,加一堆 printf 重新编译,来回猜半天还是不知道哪一步出了问题。这篇不讲原理,只给一条能照着敲的路径:怎么让程序带上调试信息、怎么断在某一行、怎么单步走、怎么看变量和调用栈,以及卡住时按什么顺序排查。适合刚学完指针和数组、还没正经用过调试器的人。

写 C/C++ 时最常见的一幕:程序崩了或者结果不对,加一堆 printf 重新编译,来回猜半天还是不知道哪一步出了问题。这篇不讲原理,只给一条能照着敲的路径:怎么让程序带上调试信息、怎么断在某一行、怎么单步走、怎么看变量和调用栈,以及卡住时按什么顺序排查。

适合刚学完指针和数组、还没正经用过调试器的人。全程按顺序来,每一步都能自己验证有没有做对。调试器只是一个能让你停下来看现场的工具,真正解决问题靠的是你观察到的数字和调用关系。

先把程序编成能调试的样子,再谈调试

新手第一次用 GDB 失败,绝大多数不是命令敲错了,而是二进制文件里根本没有调试信息。编译时要把调试开关打开、同时把优化关掉,否则断点会跳到别的行、局部变量会被优化掉,你看到的现场和源码对不上,越调越糊涂。

  1. 编译时加调试信息并关优化在编译命令里同时打开调试信息开关、把优化等级设成不优化。写 Makefile 的项目要确认最终链接出来的那份也是这么编的,别只改了其中一个目标。
  2. 确认可执行文件里真的有调试段用 readelf 或 objdump 之类工具看一眼有没有调试相关段。看不到就说明编译参数没生效,回去检查是不是被构建脚本覆盖了。
  3. 选择启动方式普通小工具直接让 GDB 加载可执行文件启动;如果是常驻服务,先让它跑起来,再用 GDB 按进程号挂上去,这样不会因为调试器启动顺序改变现场。
  4. 确认能进能出进去后先看帮助、再正常退出。卡在交互界面里出不来不算会调试,把退出和帮助这两条命令先敲熟。
调试信息
编译时额外写进可执行文件的一段数据,告诉调试器某段机器指令对应源码的哪一行、哪个变量放在哪。
优化等级
编译器做代码变换的激进程度,等级越高越会把变量塞进寄存器或直接删掉,导致调试时看不到值。
挂载进程
让调试器附到一个已经在运行的进程上,适合不方便重启的服务类程序。

断点、单步、继续:跑起来之后的三板斧

程序跑起来以后你只有三种基本动作:断在某处、一步一步走、直接放行到下一个断点。把这三件事拆开练,比一次性背一堆命令有用。断点要落得准,单步要分得清「进函数」和「当一步」,继续要能配合断点控制节奏。

你要做的事常见落点注意事项
按函数停下函数名同名重载或同名静态函数要看清停的是哪一个
按位置停下文件名 + 行号头文件里的行号会被多处引用,可能一次命中多个位置
条件停下位置 + 条件表达式循环里只关心某一次时用它,条件写错会一直不停
放行继续命令别把断点越积越多,否则每次启动都要手动放行很多次
走一步逐语句 / 逐过程逐语句会钻进函数,逐过程把整个调用当一步
  • 单步分两档:逐语句进到被调用函数里,逐过程把这一行整个执行完。分不清就容易掉进标准库或第三方库里出不来,这时候用跳出命令回到上层。
  • 临时断点适合只停一次的场景,停完自动删掉,比手动删干净。
  • 查看周围代码、列出当前所有断点、删除指定断点是配套动作,三个配合才能保证你清楚下一步会停在哪。
  • 条件断点里不要写有副作用的表达式,调试器求值可能改变程序状态,看到的现象就不是原样了。

单步走不动的常见原因

如果在某个函数里怎么走都出不来,通常是你钻进了一个没有调试信息的大库函数,或者走进了一个死循环。前者直接执行到当前函数的返回位置跳出来,后者先看循环条件里的变量怎么变,再在循环体里加条件断点缩小范围。

看到变量和调用栈,才算找到问题

停下来的那一行本身不一定有问题,真正有用的信息往往是「是谁把它变成这样的」。所以看变量的同时一定要看调用栈:当前帧是你停住的地方,往上一层是调用它的函数,再往上是更外层的调用者。

  • 打印变量和表达式是最基本的动作,注意作用域——没进到某个函数时,它的局部变量是看不到的。
  • 调用栈从当前帧往上翻,哪一层传进来的参数不对,往往比崩溃那一行更有价值。
  • 切换栈帧可以回到上层看当时的取值,配合打印上层的入参,能判断是调用方传错还是被调用方算错。
  • 数组、结构体、指针要看清楚类型和地址,指针地址明显不属于任何合理区域时,先怀疑解引用和越界,而不是编译器。
崩溃那一行只是结果,第一次出现异常值的那一层才是原因。

崩溃现场:按固定顺序看一遍

崩溃最容易让人慌,但只要按固定顺序走一遍,信息是够用的。先确认是哪种停止方式,再看现场的值,然后往上翻栈找第一次异常,最后才动手缩小复现范围。顺序反了就会一直在崩溃行附近打转。

  1. 先看停在哪、以什么方式停的段错误、断言失败、收到信号,这几类排查方向不一样。段错误重点看内存访问,断言重点看被断言的条件。
  2. 再看这一行的变量取值尤其盯住指针、下标、容量这几个数字,看下标有没有超出容量、指针有没有越界或为空。
  3. 往上翻栈找第一次异常不要停在最后崩的那一帧,往上走,找第一次出现不合理值的那一层。
  4. 缩小复现范围二分注释掉一部分代码、把复现步骤压到最短、给可疑的循环加条件断点,让问题在小样本上稳定重现。

具体某个信号或错误码在不同平台上的表现会有差别,排查细节可以到 站内指南中心(/guides) 看整理好的那几篇,按当时的系统环境对照着查,别照着旧结论硬套。

练手方式与几个高频坑

调试是手上功夫,看十篇教程不如自己造一个错。建议刻意写一个越界访问、一个空指针解引用、一个循环边界写错的小程序,把整条流程走完。走完一遍你会发现,真正花时间的不是敲命令,而是想清楚该在哪停、该看哪个值。

高频坑现象怎么处理
没带调试信息断点位置和源码对不上,变量看不到回去改编译参数,重新构建
开了优化断点跳行、变量显示被优化掉关优化重编,再复现一次
断点打在头文件同一次运行命中很多处改到具体的源文件行号上
多线程下不停在想停的线程程序一会儿停一会儿不停先切到目标线程再操作,或者用条件把范围限住
只盯崩溃那一行改了半天还是同一个错往上翻栈,找第一次值变错的那一层
  • 什么时候不该用 GDB:纯输入输出的逻辑错误,用小样本输入加几行打印更快;界面程序或大量异步回调的场景,换用日志和专门的工具更省事。
  • 复现不了的问题,先固定住运行环境和输入,再谈调试;连稳定复现都做不到,任何调试器都帮不上忙。
  • 每次调完把临时断点和临时打印清掉,否则它们会留在代码和调试脚本里,下次把别人也带沟里。

如果你还想知道主流编译器和调试工具各自的最新支持情况,可以到 站内模型与工具资料库(/models) 看整理好的条目;需要对比不同 API 服务当时的报价和可用性,到 价格追踪(/price-watch) 核对当时的数字,这类信息变化快,不要记死。

下一步把上面这套流程在自己的一个小程序上跑通一遍,再去看不同工具链和服务的对比信息,判断会清楚很多。

常见问题

为什么我打了断点却停不下来?

先查三件事:编译时有没有带调试信息、有没有开优化导致行号错位、断点打的位置是不是真的会被执行到。头文件里的函数常被多处包含,断点可能落在你不关心的那份代码里,换成文件名加行号再试。

GDB 和图形化调试器该学哪个?

看你的使用场景。在服务器、容器或者只有终端的环境里,GDB 是唯一能用的;本地写小项目,图形界面点鼠标确实更快。建议先过一遍 GDB 的命令流程,理解断点、单步、调用栈这几个概念,后面换任何工具都是同一套思路。

单步走下去还是找不到问题怎么办?

说明问题不在你走的那段路上。换个思路:先在最外层打条件断点,直接跳到出问题那次调用;或者二分注释代码,把范围压到几十行再细看。也可以先把复现步骤固定成最小输入,能稳定复现的问题基本都跑不掉。

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