python调试最常用、最轻量的工具就是内置的 pdb（Python Debugger）。它不需要额外安装，支持交互式断点控制、变量检查、单步执行，适合快速定位逻辑错误或运行时异常。掌握几个核心命令和实用技巧，就能大幅提升调试效率。
基础启动方式：三类常用入口
根据场景选择合适的方式启动 pdb：
- 程序出错时自动进入：运行时加
-m pdb参数，如python -m pdb script.py。遇到异常会停在报错行，可回溯调用栈（用u/d上下帧）。 - 代码中插入断点：在想暂停的位置写
import pdb; pdb.set_trace()（Python breakpoint()（默认调用 pdb，且受PYTHONBREAKPOINT环境变量控制）。 - 捕获异常后调试：在交互式环境（如 ipython 或 Python REPL）中，运行出错后输入
import pdb; pdb.post_mortem()，即可从崩溃现场开始分析。
高频 pdb 命令速查（精简实用版）
进入 pdb 后，输入命令并回车。以下是最常使用的 6 个命令：
- n（next）：执行当前行，不进入函数内部。
- s（step）：单步进入函数，遇到函数调用就跳进去。
- c（continue）：继续运行，直到下一个断点或程序结束。
- l（list）：列出当前附近源码（默认显示 11 行），可跟参数如
l 20,30查看指定范围。 - p 变量名：打印变量值（支持表达式，如
p len(my_list)）。 - pp 变量名：美化打印（pretty print），对字典、嵌套结构更友好。
提升效率的实用技巧
避开“反复敲命令”的低效操作，用好这些小技巧：
立即学习“Python免费学习笔记（深入）”；
- 重复上一条命令：直接按回车，等价于重复执行最后一条非空命令（比如连续按回车 = 连续
n）。 - 临时执行任意 Python 语句：在 pdb 提示符下，以感叹号开头，如
!print("debug", x)或!import os; os.getcwd()。 - 条件断点（配合 set_trace）：把
breakpoint()写在 if 判断内，例如：
if i == 100:<br> breakpoint()
这样只在满足条件时中断，避免手动 c/n 太多遍。 - 禁用/启用断点：用
disable 1、enable 1控制编号为 1 的断点（需先用b设置）；clear删除所有断点。
替代与增强方案（简单了解）
pdb 功能够用，但界面简陋。进阶可考虑：
- ipdb：IPython 版 pdb，支持语法高亮、Tab 补全、历史命令，pip install ipdb 后把
breakpoint()替换为import ipdb; ipdb.set_trace()即可。 - VS Code / pycharm 图形调试器：适合复杂项目，可视化断点、变量监视、调用栈导航更直观，底层仍调用 pdb 或其兼容协议。
- Logging + breakpoint() 混合使用：关键路径加日志输出，再在可疑位置加
breakpoint()，兼顾可追溯性与交互性。