使用GDB调试Python C扩展时，如何设置断点并执行调试命令

看起来你现在的问题出在启动命令上——你用bash来包裹python mycode.py，这导致GDB实际调试的是bash进程，而不是Python解释器本身。当Python脚本执行完毕，bash也就退出了，自然没法停下来让你控制调试。下面一步步帮你解决问题：

第一步：修正GDB启动命令 #

直接调试Python进程就好，不需要通过bash中转。两种方式任选：

• 直接带参数启动：

  gdb --args python mycode.py
  

• 先启动GDB再指定运行参数：

  gdb python
  # 进入GDB后执行
  run mycode.py
  

第二步：确保C扩展编译时包含调试信息 #

没有调试符号的话，GDB没法定位到你的C代码行号和函数，所以编译扩展时一定要加-g参数。如果用setup.py编译，修改成这样：

from setuptools import setup, Extension

my_ext = Extension(
    '你的扩展模块名',
    sources=['你的C源码文件.c'],
    extra_compile_args=['-g']  # 关键：添加调试信息
)

setup(
    name='你的扩展包名',
    ext_modules=[my_ext]
)

然后重新编译安装：python setup.py build_ext --inplace

第三步：设置断点并调试 #

这里分两种场景：

场景1：扩展模块是脚本启动时就导入的

如果你的mycode.py一开始就import了C扩展，你可以在GDB启动后、运行脚本前直接设置断点：

• 按行号设断点（比如你的C源码myext.c的第45行）：

  break myext.c:45
  

• 按函数名设断点（比如扩展里的my_c_function函数）：

  break my_c_function
  

设置完断点后，输入run启动脚本，GDB会在断点处自动停下，这时候你就可以用next（单步跳过函数调用）、step（单步进入函数）、print 变量名（查看变量值）这些命令了。

场景2：扩展模块是脚本运行到中途才导入的

如果你的扩展是在脚本执行到某一步才导入的，直接提前设断点可能会提示"pending breakpoint"（因为扩展还没加载），这时候可以用两种方法：

1. 先让Python停下来再设断点：
   在你的Python代码里导入扩展前加一行：

   input("Press Enter to load extension...")
   import 你的扩展模块名
   

   启动GDB后运行脚本，当看到终端提示输入时，回到GDB窗口，输入break my_c_function（或者行号），确认pending断点，然后回到终端按回车继续，GDB就会在扩展的断点处停下。
2. 给Python的导入函数设断点：
   在GDB里输入：

   break PyImport_ImportModule
   

   运行脚本后，每次Python导入模块都会停下，当轮到你的C扩展时，再设置具体的函数/行号断点，然后continue继续执行。

常用调试命令小结 #

• run（或r）：启动脚本
• break（或b）：设置断点，支持行号、函数名
• next（或n）：单步执行，跳过函数调用
• step（或s）：单步执行，进入函数调用
• print（或p）：打印变量值，比如p my_var
• continue（或c）：继续运行到下一个断点
• info breakpoints（或info b）：查看所有断点
• delete breakpoint 断点编号：删除指定断点

常见问题排查 #

如果断点一直不命中，先检查：

1. 编译扩展时有没有加-g参数，确认.so文件带有调试符号（可以用file 你的扩展.so命令查看，输出里有"with debug_info"就对了）
2. 断点的函数名/行号是不是正确，注意C函数的名字可能因为Python的C API规则被修饰（比如PyInit_你的模块名是初始化函数）
3. 是不是调试的进程不对——确保没有用bash中转，直接调试python进程

内容的提问来源于stack exchange，提问作者HiroIshida