GDB 源码追踪断点

调试器的主要能力之一就是设置断点。

GDB（GNU 项目调试器）现在引入了一项实验性功能——源码追踪断点，它可以追踪断点所设置的源码行位置。

简介

设想您正在进行调试：您在一堆源码行上设置了断点，检查了一些值，然后有了修改代码的想法。您编辑了源码并重新编译，但保持 GDB 会话运行，输入 run 重新加载新编译的可执行文件。由于修改了源码，断点的行号发生了偏移。目前，您只能禁用现有断点并重新设置新的断点。

GDB 源码追踪断点改变了这一局面。当您使用 file:line 符号设置断点时（启用此功能后），GDB 会捕获周围源码的一个小窗口。当您重新编译并重新加载可执行文件时，GDB 会调整任何因源码变更而导致行号偏移的断点。这在临时调试会话中尤其有用，您无需在每个编辑-编译周期后手动重设断点。

设置源码追踪断点

启用源码追踪功能：

(gdb) set breakpoint source-tracking enabled on

使用 file:line 符号设置断点：

(gdb) break myfile.c:42
Breakpoint 1 at 0x401234: file myfile.c, line 42.

GDB 现在会追踪该行周围的源码。info breakpoints 命令会显示断点是否被追踪：

(gdb) info breakpoints
Num     Type           Disp Enb Address    What
1       breakpoint     keep y   0x0000000000401234 in calculate at myfile.c:42
        source-tracking enabled (tracking 3 lines around line 42)

现在编辑源码——假设在断点上方添加了几行，将其从第 42 行移到了第 45 行。重新编译并用 run 重新加载可执行文件后，GDB 会将断点重置到新行并显示：

Breakpoint 1 adjusted from line 42 to line 45.

再次运行 info breakpoints 确认新位置：

(gdb) info breakpoints
Num     Type           Disp Enb Address    What
1       breakpoint     keep y   0x0000000000401256 in calculate at myfile.c:45
        source-tracking enabled (tracking 3 lines around line 45)

如您所见，GDB 更新了断点行以匹配新位置。

局限性

匹配算法要求捕获的源码行进行精确字符串匹配。仅空白字符的改变或追踪行的轻微格式调整会导致匹配失败，断点可能无法被找到。

GDB 仅在原始位置周围 12 行的窗口内进行搜索。如果代码偏移超过此范围——例如，因为上方插入了大段代码——则无法找到断点。GDB 将保留原始位置并打印警告：

warning: Breakpoint 1 source code not found after reload, keeping original location.

当断点以挂起状态创建时（例如启用 set breakpoint pending on），无法捕获源码上下文，因为还没有符号表可用。当断点后续解析到某个位置时，也不会被源码追踪。

范围断点（使用 break-range 设置）不支持源码追踪。

展开为多个位置的内联函数上的断点不会被源码追踪，因为每个位置的偏移可能不同。

如何尝试这一实验性功能

此功能尚未在稳定的 GDB 版本中可用。有两种方式可以尝试。

从 COPR 安装（Fedora 用户）

通过 COPR 仓库提供预构建包。启用并安装：

sudo dnf copr enable ahajkova/GDB-source-tracking-breakpoints
sudo dnf upgrade gdb

测试后禁用仓库：

sudo dnf copr disable ahajkova/GDB-source-tracking-breakpoints

COPR 项目页面：https://copr.fedorainfracloud.org/coprs/ahajkova/GDB-source-tracking-breakpoints/

从源码构建

克隆 GDB 仓库：

git clone git://sourceware.org/git/binutils-gdb.git
cd binutils-gdb

从上游邮件列表下载并应用补丁：https://sourceware.org/pipermail/gdb-patches/2026-April/226349.html

构建 GDB：

mkdir build && cd build
../configure --prefix=/usr/local
make -j$(nproc) all-gdb

运行新构建的 GDB：

./gdb/gdb

结论

GDB 源码追踪断点是一项实验性功能，目前正在上游审核中，尚未在稳定的 GDB 版本中可用。此文档链接 https://sourceware.org/gdb/current/onlinedocs/gdb.html/Set-Breaks.html 涵盖了所有可用的断点命令。如果您尝试此功能并遇到任何意外行为，非常欢迎提供反馈——您可以通过 GDB 邮件列表 https://sourceware.org/pipermail/gdb-patches/2026-April/226349.html 关注和回复上游补丁讨论。