python pdb是标准库轻量调试工具，支持代码插入断点（breakpoint()）、python -m pdb启动、pdb.pm()进入异常上下文；核心命令包括n/s/c/l/p/pp/b；可执行语句、查看变量、跳过循环；注意禁用生产环境breakpoint及多线程限制。
Python 的 pdb（Python Debugger）是标准库自带的命令行调试工具，无需安装，轻量可靠，适合快速定位逻辑错误、变量异常和执行流程问题。掌握它不依赖 IDE，能显著提升排查效率。
如何启动 pdb 调试
有三种常用方式，按场景选择：
-
在代码中插入断点：在想暂停的位置写
import pdb; pdb.set_trace()（Python 3.7+ 可直接用breakpoint()） -
运行时启动：终端执行
python -m pdb script.py，程序会在第一行暂停 -
从交互式环境进入：在 IPython 或 Python REPL 中运行代码后，调用
pdb.pm()进入最后一次未捕获异常的上下文
核心调试命令详解
进入 pdb 后，输入命令控制执行。记住这几个高频指令就覆盖 90% 场景：
- n（next）：执行下一行，不进入函数内部
- s（step）：执行下一行，遇到函数会跳进去
- c（continue）：继续运行直到下一个断点或结束
-
l（list）：显示当前附近 11 行源码，加数字如
l 20可定位到第 20 行 -
p 表达式：打印变量或表达式值，例如
p x、p len(data) - pp 表达式：美化打印（尤其对字典、嵌套结构更清晰）
-
b 行号：在指定行添加断点；
b不带参数可查看所有断点；cl 1删除第 1 个断点
实用技巧与避坑提醒
真实调试中，这些细节能省下大量时间：
立即学习“Python免费学习笔记（深入）”；
- 在 pdb 中直接执行任意 Python 语句，比如修改变量：
!x = [1, 2, 3]（前面加!表示执行语句而非 pdb 命令） - 用
a查看当前函数所有参数值，pp locals()查看全部局部变量 - 如果卡在循环里，用
unt 50（until）直接运行到第 50 行，跳过重复步进 - 避免在生产环境误留
breakpoint()：可通过设置环境变量PYTHONBREAKPOINT=0全局禁用 - 多线程调试时，pdb 默认只跟踪主线程；需配合
threading.settrace()才能进入子线程
替代方案与增强建议
pdb 功能扎实但界面简陋。日常开发中可搭配使用：
-
ipdb：IPython 版 pdb，支持语法高亮、自动补全、
!ls等 shell 命令，安装即用：pip install ipdb，然后把breakpoint()替换为import ipdb; ipdb.set_trace() -
pprint + logging：对复杂数据结构，先用
from pprint import pprint预处理再打印，比原始p更易读 - IDE 集成：PyCharm / VS Code 的图形化断点体验更直观，但理解 pdb 命令逻辑有助于读懂 IDE 底层行为
