Python单步调试方法详解

Python单步调试最常用方式是pdb模块或breakpoint()函数：前者用pdb.set_trace()设断点，后者自Python 3.7起更简洁且支持环境变量控制；IDE中可图形化断点调试，还支持附加调试运行中进程。

Python单步调试最常用、最直接的方式是使用内置的 pdb 模块，配合 IDE（如 PyCharm、VS Code）或命令行交互式调试器都能高效定位问题。

用 pdb 在代码中设置断点

在想暂停执行的位置插入 import pdb; pdb.set_trace()，运行脚本后程序会在该行暂停，进入交互式调试环境：

• n（next）：执行下一行，不进入函数内部
• s（step）：单步进入函数内部
• c（continue）：继续运行直到下一个断点或结束
• p 变量名：打印变量当前值
• l（list）：显示当前代码上下文
• q（quit）：退出调试

用 Python 3.7+ 的 breakpoint() 替代 pdb.set_trace()

Python 3.7 引入了更简洁的 breakpoint() 函数，功能等价于 import pdb; pdb.set_trace()，且支持环境变量控制（如 PYTHONBREAKPOINT=0 可全局禁用）：

• 直接写 breakpoint()，无需 import
• 在 VS Code 或 PyCharm 中，它会自动对接图形化调试器，而不是弹出命令行 pdb
• 适合团队协作，避免硬编码 pdb 导致上线遗漏

在 IDE 中图形化单步调试

PyCharm 和 VS Code 支持点击行号左侧设断点，然后点击「Debug」按钮启动：

• 按 F8 单步跳过（Step Over），类似 pdb 的 n
• 按 F7 单步进入（Step Into），类似 pdb 的 s
• 按 Shift+F8 单步跳出（Step Out）
• 变量区实时显示作用域内所有变量值，鼠标悬停也能看表达式结果

调试运行中的进程（附加调试）

对已启动的 Python 进程（比如 Flask 服务、后台脚本），可用 py-spy 或 pdb 附加调试：

• py-spy record -p --duration 10 可生成火焰图，适合性能卡顿排查
• python -m pdb -p （需系统支持）可尝试附加，但部分环境受限；更稳的方式是提前加 breakpoint() 或用 remote-pdb 开启远程调试端口