AI Skill 大全

Python 程序调试

用 breakpoint、pdb、debugpy 三种方式定位 Python 运行期错误。

功能与用途

根据情况选工具:本地交互调试最简单的是在代码里插一个 breakpoint(),正常运行到那行就进入交互环境;想不改源码就调试已有脚本,用 python -m pdb 启动;远程、无界面或需要附加到已在运行的进程上,用 debugpy,它走 DAP 协议,可从终端脚本化操作,适合长期运行的进程和子进程。它明确说了最省事的做法就是从 breakpoint() 开始。

适用场景

  • 单步跟踪与变量状态观察:在代码关键处插入断点或直接用 pdb 启动脚本,逐行单步执行并实时检查、修改上下文变量与集合状态。
  • 测试用例失败现场排查:结合 pytest 附加 --pdb 参数,在测试失败或抛出异常时自动冻结现场,直接切入交互环境定位原因。
  • 程序崩溃事后剖析:在代码触发未捕获异常后,利用 post-mortem 机制进入崩溃瞬间的作用域,快速检查现场局部变量。
  • 长运行与远程进程附加调试:针对网关、守护进程等无法轻易重启的长运行服务,利用 debugpy 监听端口或基于 PID 注入附加调试。

适用人群

  • 开发者
  • 技术团队
  • 独立开发者

使用步骤

  1. 先说清场景:本地交互、不改源码调试、还是附加到运行中进程。
  2. 按场景选工具:breakpoint() + pdb、python -m pdb 或 debugpy。
  3. 设置断点或附加进程,逐步检查变量与调用栈。
  4. 定位到问题后修复并重新验证。

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
进阶
版本
main
最近更新
2026-09-10
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

Debug Python: pdb REPL + debugpy remote (DAP).

使用前准备

  • 待调试的 Python 代码或运行中的进程
  • 可执行调试命令的终端环境
  • (远程调试时)debugpy 已安装

依赖与权限

  • HOST
  • PORT
  • 读取用户主动提供的内容

同类 Skill