PDB调试Python代码

PDB调试Python代码

调试和分析 — Python 3.14.3 文档

Python环境自带调试器PDB（Python Debugger）。

集成 PDB

方法1：在代码中插入断点

在你想暂停执行的位置加入以下代码：

import pdb; pdb.set_trace()

从 Python 3.7 开始，可以使用更简洁的内置函数：

breakpoint()  # 等价于 import pdb; pdb.settrace()

运行脚本后，程序会在该行暂停，并进入交互式调试模式。

方法2：直接从命令行启动调试器

你也可以不修改源码，直接用 pdb 运行整个脚本：

python -m pdb script.py

这样程序会在第一行暂停，你可以逐步执行或设置断点。

常用 pdb 命令

命令	说明
n (next)	执行下一行（不进入函数）
s (step)	单步执行（进入函数）
c (continue)	继续执行直到下一个断点或结束
l (list)	显示当前代码上下文
p <变量名>	打印变量值（如 p a）
pp <变量名>	漂亮打印（pretty-print）变量
w (where)	显示当前调用栈
q (quit)	退出调试器（会终止程序）
h (help)	查看帮助

其他高级调试工具

虽然 pdb 足够强大，但如果你需要更友好的界面，可以考虑：

• ipdb：基于 IPython 的 pdb，支持语法高亮、自动补全等。

  pip install ipdb
  

  使用方式：

  import ipdb; ipdb.set_trace()
  

• pudb：全屏终端 GUI 调试器（适合喜欢可视化界面的用户）。

  pip install pudb
  python -m pudb script.py