配置Sublime Text的Python调试环境需先安装Package Control,再通过插件如SublimeREPL、Terminus和Anaconda扩展功能,接着设置自定义Build System运行脚本,利用Terminus内嵌终端实现快捷运行,并结合pdb模块插入断点进行命令行调试,从而在无图形界面情况下高效完成Python开发与调试任务。

Sublime Text 本身不带内置调试器,但通过插件和外部工具可以实现 Python 代码的运行与调试。下面介绍如何配置 Sublime Text 的 Python 调试环境,让你更高效地编写和测试代码。
安装 Package Control 和必要插件
Package Control 是 Sublime 的插件管理工具,几乎所有功能扩展都依赖它。
- 按下 Ctrl+` 打开控制台,粘贴以下代码并回车: import urllib.request,os; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener( urllib.request.build_opener( urllib.request.ProxyHandler()) ); open(os.path.join(ipp, pf), 'wb').write(urllib.request.urlopen('http://packagecontrol.io/' + pf.replace(' ', '%20')).read())
- 重启 Sublime,按 Ctrl+Shift+P 输入 “Install Package” 搜索插件管理器。
- 推荐安装以下插件:
- SublimeREPL:可在 Sublime 内部运行 Python 解释器,支持交互式调试。
- Terminus:在编辑器内嵌终端,直接运行 Python 脚本。
- Anaconda:提供代码补全、错误提示、Goto 定义等功能(注意不是 Anaconda 发行版)。
配置 Build System 运行 Python
通过自定义构建系统,可快速运行当前脚本。
- 点击菜单栏:Tools → Build System → New Build System
- 输入以下内容,保存为
Python3.sublime-build:
"cmd": ["python", "-u", "$file"],
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python"
}
如果你使用的是虚拟环境或特定路径的 Python,把 "python" 改成完整路径,例如:
立即学习“Python免费学习笔记(深入)”;
"cmd": ["C:/Users/Name/AppData/Local/Programs/Python/Python39/python.exe", "-u", "$file"]保存后,在 Python 文件中选择 Tools → Build System → Python3,按 Ctrl+B 即可运行代码。
使用 Terminus 实现内联终端调试
Terminus 提供一个嵌入式终端,适合查看输出和简单调试。
- 安装 Terminus 后,按 Ctrl+Shift+P 输入 “Terminus: Open Default Shell” 打开终端面板。
- 在终端中输入命令运行脚本: python your_script.py
- 也可创建快捷键绑定,一键运行当前文件:
- 打开 Preferences → Key Bindings,添加如下内容:
{
"keys": ["ctrl+alt+b"],
"command": "terminus_run",
"args": {
"cmd": "python $file",
"title": "Run Python",
"panel_name": "Python Run"
}
}
]
之后按 Ctrl+Alt+B 就能在 Terminus 面板中运行当前脚本。
结合 pdb 进行断点调试
由于 Sublime 不支持图形化调试,建议使用 Python 自带的 pdb 模块进行调试。
- 在代码中插入断点: import pdb; pdb.set_trace()
- 用上面配置的 Build System 或 Terminus 运行脚本,程序会在断点处暂停。
- 在终端中使用 pdb 命令进行调试,如:
- n:执行下一行
- s:进入函数
- c:继续执行
- p 变量名:打印变量值
基本上就这些。虽然 Sublime 不像 PyCharm 或 VS Code 那样有可视化调试界面,但搭配构建系统、Terminus 和 pdb,完全可以满足日常调试需求。关键是流程要顺,操作要快。











