gdb设断点关键在于精准定位符号:单函数用break函数名;重载/模板/类成员需完整签名或作用域;rbreak支持正则批量匹配;条件断点可结合参数判断;注意-g编译、static限制及模板符号混淆。

直接用 break 加函数名就行,但同名函数、重载、模板或类成员函数时容易设错位置——关键不是“能不能设”,而是“设到哪个符号上”。
给单个唯一函数设断点
最常见场景:C 函数或无重载的 C++ 函数。GDB 会自动解析符号并停在函数入口第一行可执行指令处。
-
break printf→ 停在 libc 的printf入口(需有调试符号,否则可能提示“no debugging symbols”) -
break main→ 无论源文件名是什么,都能命中程序入口 - 如果函数在当前文件里,且未被内联(编译加
-O0 -g),break my_func就够用
处理多个同名函数(重载/模板/多文件定义)
GDB 默认只选第一个匹配的符号,但实际可能有多个 printNum:一个在 test.c,一个在 utils.cpp,C++ 还可能有 printNum(int) 和 printNum(double)。这时直接 break printNum 会报歧义或随机选一个。
- 用完整签名缩小范围:
break printNum(int)(C++)或break test.c:printNum - 查看所有匹配项:
info functions printNum,它会列出符号名、文件、类型,例如:void printNum(int) at test.c:3 - 类成员函数必须带作用域:
break MyClass::do_work,不能只写do_work
用正则批量设置函数断点
当要调试一组命名有规律的函数(比如所有以 log_ 开头的),手动逐个设太慢,rbreak 就是为此设计的。
-
rbreak ^log_→ 匹配所有以log_开头的函数(^表示行首,避免匹配到my_log_func中的子串) -
rbreak utils\.cpp:.*_impl→ 只在utils.cpp里匹配含_impl后缀的函数(注意点号要转义) - 它本质是按符号表名匹配,不是源码文本;所以
rbreak main仍只设一个断点,不是“所有叫 main 的函数”
条件断点 + 函数入口的组合用法
光停在函数开头不够,常需要“只在特定参数下调用时才断”。这时候不能靠 if 写在函数体里——得在入口就判断参数值。
-
break printNum if a == 5→ 每次进入printNum都检查形参a是否等于 5 - 注意:C++ 成员函数中,
this是合法变量,可用break MyClass::process if this->id == 42 - 条件表达式必须能在断点触发时刻求值;若参数已被优化掉(如
-O2),GDB 会提示Cannot evaluate expression—— 此时要么降级优化,要么改用寄存器观察(如print $rdi)
最容易被忽略的是符号可见性:没加 -g 编译,或者函数被 static 修饰且未被内联,break 可能根本找不到符号;而模板实例化函数名在符号表里是 mangled 的(比如 _Z8printNumIiEvT_),直接输名字会失败——这时候得先 info functions 确认真实符号名,再设断点。











