Python调试技巧：pdb使用全攻略

Python 自带调试工具 pdb 可通过插入 import pdb; pdb.set_trace() 或命令行 python -m pdb your_script.py 启动。常用命令包括：1. n 执行下一行；2. s 单步进入函数；3. c 继续执行；4. l 显示当前代码；5. p 变量名 打印变量；6. q 退出调试。可通过 b 行号 设置断点，w 查看堆栈，u/d 切换堆栈帧，实现高效问题定位。

调试 Python 代码时，很多人第一反应是加一堆 print 输出变量值。其实 Python 自带了一个非常实用的调试工具：pdb（Python Debugger）。它能让你一行一行地执行代码、查看变量状态、设置断点，非常适合排查逻辑错误和复杂问题。

怎么启动 pdb？

最简单的办法就是在你想开始调试的地方加上这句：

import pdb; pdb.set_trace()

程序运行到这里就会暂停，进入交互式调试模式。你就可以输入命令查看当前上下文了。

如果你不想改动代码，也可以通过命令行直接启动：

python -m pdb your_script.py

这样会从脚本的第一行开始调试。

常用命令有哪些？

进入调试模式后，你会看到 (Pdb) 提示符，这时候可以输入各种命令：

• n(ext)：执行下一行代码，遇到函数调用不会进去。
• s(tep)：单步执行，如果当前是函数调用，会进入函数内部。
• c(ontinue)：继续执行直到下一个断点或程序结束。
• l(ist)：显示当前执行位置附近的代码。
• p <变量名>：打印某个变量的值，比如 p x。
• q(uit)：退出调试器并终止程序。

这些命令组合起来，就能快速定位问题所在。

怎么设置多个断点？

除了手动插入 pdb.set_trace()，你还可以在调试过程中动态添加断点。进入调试器后，使用：

b <行号>

比如 b 10 就是在第10行设一个断点。你也可以指定文件名，比如：

b module.py:20

查看所有断点用 b 不带参数，删除断点可以用 cl <断点编号>。

调试的时候怎么看堆栈？

有时候你会发现程序停在某个地方，但不知道是怎么走到这里的。这时候可以用：

• w(here)：查看当前调用堆栈。
• u(p) 和 d(own)：上下切换堆栈帧，查看不同层级的变量状态。

这对分析递归、回调或者多层嵌套函数特别有用。

基本上就这些。pdb 的功能其实还有很多，比如条件断点、跳过异常等，但在日常开发中，上面这几招已经够用了。关键在于熟悉流程、灵活使用，调试效率自然就上来了。