Linux C/C++ 调试的那些“歪门邪道”

鸣涧

Linux C/C++ 调试的那些“歪门邪道”

来自：知乎，作者：韦易笑

链接：https://zhuanlan.zhihu.com/p/32843449

无数次被问道：你在终端下怎么调试更高效？或者怎么在 Vim 里调试？好吧，今天统一回答下，我从来不在 vim 里调试，因为它还不成熟。那除了命令行 GDB 裸奔以外，终端下还有没有更高效的方法？能够让我事半功倍？

当然有，选择恰当的工具和方法，让 GDB 调试效率成倍的提升并没有任何问题。当然，前提条件是你至少会在使用最原始的 GDB。

裸奔状态：原始的 GDB 命令行

穿上各种衣服前，至少得先学会裸奔，找份简单的 GDB cheat sheet 对照一下：

生产环境中出现崩溃时，因线上服务器一般没有开发环境，也无配套源代码，所以程序崩溃后，如果你懒得把 core 文件拖回到开发机检查，可以先在线上服务器先简单gdb看一下。

GDB命令密密麻麻，常用的也就表格上那几条，比如进去以后第一步先用 bt 查看一下调用栈，info local查看一下本地变量，再配合 up/down 在整个调用栈的不同层次之间上下移动一下，检查各处局部变量的值，print 一下某个表达式，即便没代码，看下符号和反汇编，一般也能调试个七七八八。

碰到复杂点的 BUG，必须配合源代码了，那你得把 core 文件拉到开发环境中，再用 gdb 对照源代码调试，配合 list [行号] 指令查看当前运行的源代码，再配合其他方法进行调试。

那么这时候，如果调试复杂度继续上升，你需要不断的断点，每次 next / step 单步完后你都需要 list 一下前后源代码，或者用 disassemble [函数名/地址] 查看一下指令的话，不少人会感觉到抓狂，这时我们需要给裸奔的 GDB 穿条内裤了。

穿上内裤的 GDB - TUI

这是 gdb 自带的文本界面，使用 gdb -tui 命令启动，比如：

gdb -tui hello

即可打开我们的文本界面：

上方是源代码窗口，下面是 gdb 终端，窗口管理快捷键模仿 emacs，使用 c-x o 进行窗口切换，如果你还想查看指令窗口，可以输入：layout split

然后你单步的时候上面的源代码窗口会跟着滚动，比之前不停的 list 方便不少吧，要看前后源代码可以继续 c-x o 切换窗口后上下滚动。

有时候你 up/down 切换了栈帧后，上面的代码也许来不及更新，那么你用 update 指令，让上面的代码窗口定位到你最新的执行位置，有时也需要 CTRL-L 重绘下整个界面。

在 gdb 自带的 tui 模式中，你不但可以随时查看代码/指令，还可以查看寄存器。好吧，其实 gdb再简陋，本身还是配套了一条内裤的，只是很多人忘记拿出来穿了。

穿上内衣：gdbinit

如果上述文本 TUI的信息不够丰富的话，也许你会对 .gdbinit 感兴趣，~/.gdbinit 是一个 gdb配置脚本，可以设定一些由 python 编写的插件，比如 peda：

在 ~/.gdbinit 上面配置了 peda 后，可以看到命令提示符就从 (gdb) 变成了 gdb-peda$ 。每敲一个单步命令，peda 都会显示出无比丰富的信息，你还可以配置添加更多，配合高亮，你可以得到一个加强版的命令行。

不过这个我用的并不多，因为它会影响 TUI 模式的界面，我不喜欢在我的 gdb 里搞太多乱七八糟的东西。同时，当我们的调试需求继续变得更加复杂，你要不停的断点，频繁的单步，这些传统命令行里不停的输入各种指令显然已经让我们疲惫不堪了，能否直接在界面上查看源代码并且直接在代码上快捷键断点，快捷键单步呢？

可以啊，试试 cgdb。

穿上外套的 GDB：cgdb

CGDB 类似 gdb tui 分为终端窗口和代码窗口：

上面的代码窗口称为 cgdb mode, 下面的 gdb 窗口称为 gdb mode，调试就是不停的在两种模式间切换，按键模仿 vim，按 ESC 切换回 cgdb 模式，按 i 切换到 gdb 模式。

这看起来和 TUI gdb 差不多啊？除了语法高亮外它比 gdb tui 高效在哪里呢？答案是：大部分操作皆可在 cgdb mode 下（即源代码窗口）用快捷键操作。

方向键 或者 hjkl 移动光标，page-down/up 或 c-f / c-b 前后翻页，按 o键会列出当前可执行文件的源代码列表，可以切换查看其他相关代码文件，按 / 或者 ？可以进行文档搜索。

上面这些快捷键基本和 vim 对应，能让你方便的浏览源代码，同时在代码窗口可以用空格键来切换断点，还有其他一些快捷键：

• F5 - Send a run command to GDB.
• F6 - Send a continue command to GDB.
• F7 - Send a finish command to GDB.
• F8 - Send a next command to GDB.
• F10 - Send a step command to GDB.
  

更多快捷键见【这里】，这下单步和断点比原来轻松多啦，你基本可以呆在源代码窗口里不出来，大部分时候不用再到 gdb 命令行里一条条 next/step 的输入了。

编辑一下 ~/.cgdb/cgdbrc ，简单调教下使用更方便：

set ignorecase
set ts=4
set wso=vertical
set eld=shortarrow
set hls
map <F9> :until<cr>

这里大概设置了搜索大小写不敏感，tab 大小，分屏方式（默认改为左右分屏），搜索高亮，以及加了一个 F9 的快捷键，用于跳出循环（默认没有这个快捷键）：

现在大家都是宽屏显示器了，默认改成左右分屏（要 cgdb 7.0才支持）舒服不少。

cgdb 还有更多功能，比如没有源文件时可以查看汇编，或者交叉查看源代码和汇编，设置 mark 等等，具体见它的官方文档吧。

这个小工具能将你从大量 gdb 命令行中解脱出来，配置文件还可以让你按喜好绑定各种命令到快捷键上。

穿戴整齐：Emacs GDB

CGDB 虽然大部分操作可以用快捷键进行，但是仍然有不少时候需要切换回右边的 gdb mode 中去敲命令，比如当你需要每单步一次就用 info local 查看一下局部变量或者 print 一下某个全局变量的值的时候，频繁的左右切换会让你疲于奔命。

所有在调试一些相对复杂的问题时，上面这些工具 hold 不住了，作用平时 Vim 写代码的人，我也从不拒绝用 emacs 的 gdb mode 来调试一些复杂问题，毫无疑问 emacs 是目前终端下最强的 GDB 前端。

从来没用过 emacs 都没关系，只要安装一个 emacs 记得下面几条命令就可以调试了：

• 切换文件：c-x c-f （先按 ctrl_x 再按 ctrl_f），输入文件名时可以用 tab 补全
• 移动光标：方向键，或者 c-f, c-b, c-p, c-n；翻页 pgup/down 或者 c-v / m-v
• 切换缓存：c-x b 切换当前窗口里的缓存，c-x c-b 打开新窗口切换缓存。
• 窗口操作：c-x o 窗口切换，c-x 2 / c-x 3 上下/左右分屏，c-x 0 / c-x 1 关闭 / 独占
• 输入命令：m-x （按 ALT_x）输入命令可以用 tab 补全，c-g 退出命令输入。
  

当然，别忘记退出命令是 c-x c-c，这就够了，首先我们启动 emacs：

按下 m-x （alt+x），提示输入命令（如果终端软件 alt 键不灵，那可以设置一下终端软件，或者一秒内先按 ESC，再按 x键，在 xterm 终端下是等价的），键入 “gdb”敲回车：

下面会问你怎么运行gdb，输入gdb的 shell 启动命令行回车后开始 gdb 模式：

看到这里也许你会问，这和直接命令行 gdb 有区别么？别急，继续 m-x 输入命令：

gdb-many-windows

马上满足你：

左上是 GDB 终端，从上到下分别是：GDB终端，本地变量监控，源代码，程序输出，栈帧，断点列表。

当然你可以接着在 gdb 终端里输入你想要的指令，但大部分时候我们会在源代码窗口工作，使用 c-x o 将窗口定位到源代码窗口，使用下面命令或者对应快捷键进行操作：

这些 gud- 开头的命令都是 emacs gdb-mode 下通用调试器的操作命令，他们和 gdb 命令一一对应，可以用 m-x 输入这些命令，还可以直接用快捷键操作。

如果你想把某个窗口替换成反汇编或者寄存器的监控，那么可以用 m-x 输入：

gdb-display-disassembly-buffer

那么其中一个窗口就会被切换成反汇编窗口：

左上角的 gdb 终端被切换成反汇编窗口了，看完后记得 c-x b 切换回 gdb 控制台，如果你要避免某个窗口被切换走可以搜索 emacs 的 dedicated window。再者，我们可以自己用窗口管理快捷键按照我们的喜好拆分布局：

比如重新拆分了一下，把 gdb 终端挪到右边，输出窗口下面，把原来显示 gdb 终端的地方显示为反汇编。基本上你在 IDE 上见得到的调试手段，在 emacs 中都可以操作，并且 emacs 还可以在 Windows 下用 gdb 调试 mingw 的程序。

那么也许你会抱怨 emacs 下操作是在太麻烦了，没关系，稍微调教一下即可。

调教 emacs gdb-mode

打开 ~/.emacs （windows下是 ~/_emacs）文件，输入如下内容：

(global-set-key [M-left] 'windmove-left)
(global-set-key [M-right] 'windmove-right)
(global-set-key [M-up] 'windmove-up)
(global-set-key [M-down] 'windmove-down)

(global-set-key [f5] 'gud-run)
(global-set-key [S-f5] 'gud-cont)
(global-set-key [f6] 'gud-jump)
(global-set-key [S-f6] 'gud-print)
(global-set-key [f7] 'gud-step)
(global-set-key [f8] 'gud-next)
(global-set-key [S-f7] 'gud-stepi)
(global-set-key [S-f8] 'gud-nexti)
(global-set-key [f9] 'gud-break)
(global-set-key [S-f9] 'gud-remove)
(global-set-key [f10] 'gud-until)
(global-set-key [S-f10] 'gud-finish)

(global-set-key [f4] 'gud-up)
(global-set-key [S-f4] 'gud-down)

(setq gdb-many-windows t)

解释一下，最上面设定了 ALT + 方向键就可以在窗口中跳转，如果你终端 alt+方向不灵的话可以改成 C-left, C-right 等用 ctrl + 方向键移动窗口，后面设定了一些常用命令的快捷。

最后设置了默认打开 gdb-many-windows，最好增加下面一段，允许鼠标操作：

(require 'xt-mouse)
(xterm-mouse-mode)
(require 'mouse)
(xterm-mouse-mode t)
(defun track-mouse (e))

(setq mouse-wheel-follow-mouse 't)

(defvar alternating-scroll-down-next t)
(defvar alternating-scroll-up-next t)

(defun alternating-scroll-down-line ()
  (interactive "@")
    (when alternating-scroll-down-next
      (scroll-down-line))
    (setq alternating-scroll-down-next (not alternating-scroll-down-next)))

(defun alternating-scroll-up-line ()
  (interactive "@")
    (when alternating-scroll-up-next
      (scroll-up-line))
    (setq alternating-scroll-up-next (not alternating-scroll-up-next)))

(global-set-key (kbd "<mouse-4>") 'alternating-scroll-down-line)
(global-set-key (kbd "<mouse-5>") 'alternating-scroll-up-line)

这下 xterm 下你可以自用的用鼠标点击切换窗口，点击按钮，用滚轮上下查看源代码了：

这下自由多了，ALT+方向或者鼠标点击，直接窗口跳转，并且用下面的命令操作：

• F5 - 运行，Shift + F5 - 继续
• F7/F8 代码级单步， 以及 Shift-F7/F8 指令级单步
• F9 - 设置断点，Shift-F9 删除断点
• F10 - 跳出循环，Shift-F10 跳出函数
• F4 - 移动到上一个调用栈帧，Shift-F4移动到下一个
  

右上角的本地变量窗口上面有两个按钮，可以鼠标点击切换显示本地变量还是寄存器。右下角的也有两个按钮切换显示断点还是线程。最上面绿色部分的按钮也可以直接鼠标点击。

终于比我们最初的版本好用多了，如果你喜欢折腾的话，你还可以定制 gdb-many-windows 的初始格局，比如更复杂的：

彻底满足你各种复杂的调试需求，这里不展开了，有兴趣见【这篇文章】。

最后每次调试时打开 emacs, m-x输入 gdb 再键入文件名很麻烦？我们调教一下 .bashrc：

gdbtool () { emacs --eval "(gdb \"gdb --annotate=3 -i=mi $*\")";}

好了，终端下我们对要调试的程序只需要输入：

$ gdbtool hello

就能自动打开 emacs 并且切换到 gdb-mode 下面，展开我们的多窗口，开始调试了，是不是很愉快？

我平时调试没环境会先使用 gdb-tui 先看看，有环境或者问题复杂了我会打开 emacs 来调试。后来

@zpan

给我介绍了 cgdb 以后，gdb-tui 就退役了，无环境先用 cgdb 看个大概，碰到复杂问题打开 emacs，经过一番调教，十分顺手。

让 GDB 变得更性感一些

其实到 emacs 已经差不多了，但如果你实在记不住这有限的几个快捷键或者 gdb 命令，那么还可以尝试一下 gdbgui：

python 开发的基于浏览器的 GDB 前端，pip 安装一下即可，使用时：

gdbgui --host 0.0.0.0 hello

就会监听本地 5000 端口，这时我们可以用浏览器打开服务器上的地址完全用鼠标进行调试。

中间是程序代码，下面是 GDB终端，上面可以切换源代码，可以控制运行/继续/单步等。右边可以实时查看：本地变量，调用栈帧，内存地址，断点，线程 等等。

比如上面的调用栈和线程查看，以及下面的自定义结构体查询：

还能可视化查询数据结构：

鼠标点击代码左边就可以设置/删除断点，点击上面的按钮就能切换显示汇编代码。基本上把 GDB的主要功能都用可视化的方式，现代的网页界面展示在你的面前，不需要记住任何快捷键，鼠标点点点就可以了。

同时，这个 gdbgui 还支持 Windows 下的 gdb 调试。目前 gdbgui 还在活跃的开发中，作为最漂亮的 gdb 前端，相信它会越来越强大。

回顾一下

好了我们经历了从最开始 gdb 的命令行裸奔状态到终端下最完善的调试环境 emacs gdb-mode，再到性感的 gdbgui。GDB 的好处就在于对内可以引入各种插件，对外可以提供各种接口，自己做好调试的事情，前端界面可以完全交给其他程序来主导，不管是本地还是远程，所以才会有了各种各样丰富的 GDB Front End，还有各种远程 GDB 工具。

它不会限制你说你只能这样调试，或者你只有唯一的一种 UI可以操作，所以 GDB 的组合方式千千万万，用不着一谈 GDB 就觉得只有原始的敲命令一种用法，对吧？上面么多用法，随便选两样，花不了半小时，即可让你终端下的调试工作加快不少。