GitHub Store
inducer

pudb

inducer

pudb 是 Python 全屏终端可视化调试器，在终端里提供源码高亮、变量监视与断点管理，适合无 GUI 的远程开发与服务器环境。

v2026.1
发布于
14 天前
3,249
星标
84
下载
同步于
8 天前

最新版本

v2026.12026年10月14日 01:23
下载慢？可在上方随时切换镜像源

项目说明

项目概述

pudb 是一个基于终端的 Python 可视化调试器，目标是把现代 GUI 调试器的体验带进更轻量、更依赖键盘的终端环境。源码、调用栈、断点与变量同屏展示并持续更新，变量树可展开折叠。它适合在服务器或远程环境中直接调试代码，支持主题切换、模块浏览器与事后调试模式。

项目 内容
类型 终端可视化调试器
语言 Python
运行要求 Python 3.6+
界面 全屏字符界面（urwid）

把 GUI 调试器的体验装进终端，服务器上也能舒服断点。

主要功能

  • 同屏总览：源码、栈、断点、变量同屏显示并实时刷新
  • 变量树：变量显示可展开、折叠与自定义
  • 键盘导航：单键操作，支持方向键与 Vi 快捷键
  • 断点管理：光标指行按 b 设断点，断点窗口可视化编辑
  • 运行到行：按 t 直接运行到光标所在行
  • 内嵌 shell：按感叹号进入当前环境的 Python shell
  • 模块浏览器：按 m 查看与重载已加载模块
  • 事后调试：post-mortem 模式回溯崩溃前的执行路径

适用人群

  • 服务器端 Python 开发者
  • 远程开发与 SSH 工作流用户
  • 不想离开终端的工程师
  • 科学计算开发者
  • 教学 Python 调试的教师

快速上手

  1. 安装 pudb
pip install pudb
  1. 在代码中插入断点
import pudb
pudb.set_trace()

  1. 运行脚本即在终端打开调试界面

  2. 常用键位：b 设断点、t 运行到行、! 进 shell、Ctrl-P 切主题

核心优势

  • 终端友好：无需 GUI 即可获得完整可视化调试体验
  • 上手快：键位参考 pdb，单键操作高效
  • 主题丰富：内置多套主题并支持自定义

系统要求

项目 要求
操作系统 Linux、macOS 等终端环境
语言环境 Python 3.6 及以上
界面依赖 urwid

注意事项

  • 终端要求：需要支持全屏字符界面的终端模拟器
  • 旧版支持：2019.2 及更早版本才支持 Python 2.7
  • pytest 集成：可作为 pytest 插件在测试失败时进入调试

历史版本

排序