首先安装Debugger插件并配置Python调试环境,接着在代码中设置断点并使用F5启动调试,通过快捷键实现单步执行和函数跳转,最后注意确保Python解释器可用并根据需要指定路径或环境参数。

Sublime Text 本身不是完整的 IDE,但通过插件可以实现类似 IDE 的调试体验。其中 Debugger 插件是目前 Sublime 上最接近真实调试器的工具,支持断点、变量查看、单步执行等功能。下面手把手教你如何配置 Debugger 插件来调试 Python 代码。
1. 安装 Debugger 插件
打开 Sublime Text,使用 Package Control 安装 Debugger:
- 按下 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(Mac)打开命令面板
- 输入 Package Control: Install Package 并回车
- 等待列表加载完成后,搜索 Debugger
- 点击安装,安装完成后会自动添加调试菜单
2. 配置 Python 调试环境
安装完成后需要告诉 Debugger 如何运行你的 Python 文件:
- 点击顶部菜单 Tools → Command Palette 或继续用 Ctrl+Shift+P
- 输入 Debugger: Open Launch Configurations
- 选择当前项目或创建新配置文件
- 在弹出的 JSON 文件中添加以下内容:
{
"configurations": [
{
"type": "python",
"request": "launch",
"name": "Debug Python File",
"program": "${file}",
"console": "integrated",
"cwd": "${fileDirname}",
"env": {}
}
]
}
说明:
立即学习“Python免费学习笔记(深入)”;
-
type: python表示使用 Python 调试器 -
program: ${file}表示运行当前打开的文件 -
console: integrated使用 Sublime 内置终端输出 -
cwd: ${fileDirname}设置工作目录为文件所在目录
3. 设置断点并开始调试
配置完成后就可以开始调试了:
- 打开一个 .py 文件
- 在行号左侧点击,出现红点表示设置断点
- 按下 F5 或通过菜单 Debug → Start Debugging
- 调试控制台会在底部打开,显示变量、调用栈和输出
你可以使用以下快捷键进行调试操作:
- F5:启动/继续
- F9:切换断点
- F10:单步跳过(Step Over)
- F11:单步进入(Step Into)
- Shift+F11:跳出函数(Step Out)
4. 常见问题与注意事项
- 确保系统已安装 Python,并能在终端中通过
python或python3命令运行 - 如果提示找不到解释器,可在配置中显式指定路径:
"python": "/usr/bin/python3"或"python": "C:\\Python39\\python.exe" - 某些复杂项目可能需要设置
env或args参数 - 不支持多线程调试、远程调试等高级功能
基本上就这些。虽然 Sublime 的调试能力不如 PyCharm 或 VS Code 强大,但对于轻量开发和快速排查问题已经足够实用。关键是配置一次后,以后都能直接使用。










