Python debugger 是什么?如何一步步查看代码执行过程

Python debugger 是 Python 自带的运行时调试工具，核心能力是在代码执行到某一行时暂停，然后由你控制“下一步执行哪里”，同时查看当前作用域里的变量值和函数调用栈。它适合排查“结果和预期不一致”“不知道哪一步把变量改坏了”“递归/循环到底走了哪条分支”这类问题。最轻量的用法是在代码里插入 breakpoint()，运行后自动进入调试器；如果你用 VS Code、PyCharm 等 IDE，图形化调试器提供同样的能力，只是把命令换成了按钮。

Python debugger 能做什么

调试器不是“自动找 bug”的工具，它给你的是执行控制权和状态可见性：

• 暂停执行：在指定位置停下来，此时程序状态被冻结。
• 逐步执行：一次只走一行、进入函数内部、或跳出当前函数。
• 查看变量：随时打印任意变量、表达式、容器内容。
• 查看调用栈：知道当前函数是被谁调用的、参数是什么、返回值会回到哪里。
• 改变执行路径：临时修改变量值、跳过某段代码、强制返回。

这几点组合起来，就能回答“代码到底是怎么一步步跑到这个结果的”。

两种常用方式：命令行 pdb 与 IDE 图形化

两者底层是同一套机制，选哪个取决于你的运行环境。服务器上跑的程序通常只能用 pdb；本地写代码时图形化更省事。

用 breakpoint() 一步步查看执行过程

前提：Python 3.7 及以上，breakpoint() 内置可用（它默认调用 pdb）。

第一步：插入断点。 在你怀疑出问题的那一行之前加一行：

def total(items):
    result = 0
    for item in items:
        breakpoint()          # 每次循环都会在这里暂停
        result += item
    return result

total([1, 2, 3])

第二步：运行程序。 正常执行 python script.py，程序会在断点处停下，终端出现 (Pdb) 提示符。

第三步：用命令控制执行。 常用命令：

• n（next）：执行当前行，停在下一行；不进入函数内部。
• s（step）：执行当前行；如果这行调用了函数，进入该函数。
• c（continue）：继续运行，直到下一个断点或程序结束。
• p 变量名：打印变量值，如 p item、p result。
• pp 变量名：美化打印，适合字典、列表等结构。
• where 或 bt：查看当前调用栈。
• q：退出调试器。

第四步：观察变化。 在循环里反复按 n，每次用 p result 看累加结果，就能确认“第几次循环开始偏离预期”。预期结果是：你能看到 result 从 0 → 1 → 3 → 6 逐步变化，如果某一步不对，问题就定位到了那一行。

验证方法：把断点放在函数入口，用 s 进入函数，再用 where 确认调用链，最后 c 让程序跑完，对比最终输出是否和手算一致。

调试循环、递归和函数调用

循环：断点放在循环体内，反复 n 并 p 关键变量，观察每一轮的输入输出。如果循环次数很多，可以在断点前加条件，例如只关心某一轮，就用 p 检查后决定是否 c 跳过。

递归：递归的难点是“同一行代码被多次执行，每次的局部变量不同”。用 s 进入递归调用，用 where 看栈帧，你会看到同名函数一层层堆叠。每层用 p 看参数，就能判断是“递归没终止”还是“返回值没正确传回”。

函数调用：用 s 进入被调函数，用 r（return）直接执行到当前函数返回，再用 p 看返回值。这能快速确认“是函数内部算错了，还是调用方用错了返回值”。

常见卡点

• 断点不生效：确认代码真的执行到了那一行（可能被 if 分支跳过）；确认运行的是你改过的文件，而不是缓存或另一个副本。
• 总是进入第三方库：用 n 而不是 s，避免一步步走进库函数；或在 IDE 里设置“仅调试我的代码”。
• 多线程：pdb 一次只能控制一个线程，其他线程可能继续运行，导致状态和你看到的不一致。调试多线程时优先缩小范围、加日志。
• 异步代码：await 会让执行在事件循环中切换，单步跟踪容易跳到不相关的协程。建议在关键 await 前后打日志，或只在确定的协程内设断点。
• 变量名和命令冲突：如果变量叫 n、c、p，直接输入会被当成命令。用 p 变量名 明确打印。

用可视化工具辅助理解执行流程

命令行和 IDE 调试器输出的是文本状态，理解递归、矩阵变换、引用关系这类结构时，光看变量值不够直观。staying Code Visualization Platform 的做法是把 Python、JavaScript、C/C++ 的执行过程可视化：输入代码后，可以逐行步进，同时看到当前执行行、变量值以及数据结构的变化，并提供了递归、广度优先遍历、键值查找等示例。它更适合学习和讲解“代码是怎么跑的”，而不是替代生产环境里的断点调试。如果你已经会用 pdb，但想更直观地看清调用栈和数据结构的演变，可以把它当作辅助观察工具；实际排查线上问题时，仍然以 pdb 或 IDE 调试器为准。