SuperAPI AI 工具集

python-debugpy

编程与开发

查看项目

更新于 10-16 06:43

技能介绍

用途:为 Python 代码排错,按场景在 pdb 本地交互调试、脚本免改源码启动、测试失败捕获和 debugpy 远程附加之间选择。资料建议优先使用 breakpoint(),因其成本最低。

主要能力:pdb 提供 n/s/r/c/until/j/l/w/u/d/a/p/pp/display/b/tbreak/!/interact/q 等命令;支持条件断点与一次性断点;interact 可进入当前作用域的完整 REPL(局部变量默认只读,需用 !x = 42 修改)。debugpy 支持三种模式:源码中 debugpy.listen + wait_for_client、python -m debugpy --listen 127.0.0.1:5678 --wait-for-client 启动、以及 --pid <pid> 附加到运行中进程。remote-pdb 通过 set_trace(host, port) 后用 nc 连接,得到普通 (Pdb) 提示符。

必要用法:本地断点直接加 breakpoint();免改源码用 python -m pdb path/to/script.py;测试用 scripts/run_tests.sh ... --pdb 或 --trace;事后剖析用 pdb.post_mortem(sys.exc_info()[2]) 或 python -m pdb -c continue script.py;远程调试先 pip install debugpy,附加需目标环境已安装并用 --pid。连接客户端可用 VS Code/Cursor/Zed 的 attach 配置(type: debugpy,端口 5678)。

限制与坑位:pdb 在 pytest-xdist 下静默失效,需加 -p no:xdist 或 -n 0;breakpoint() 在 CI/非 TTY 下会挂起进程,不应提交;PYTHONBREAKPOINT=0 会禁用断点;debugpy 不调用 wait_for_client 则不阻塞;--pid 注入受 ptrace_scope 限制(默认仅同用户子进程,可用 echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope);pdb 只调试当前线程、不跟随 fork;协程中 await 需 Python 3.13+ 或 interact。调试完用 rg -n 'breakpoint()|set_trace(|debugpy.listen' --type py 检查清理。