Sublime Text 运行 Python 依赖系统 PATH 中的 python/python3 命令,需先验证终端可执行 python --version;再配置正确命名(Python.sublime-build)、存放于 Packages/User/ 的 build system;避免 input() 并注意编码问题。

Sublime Text 本身不内置 Python 运行环境,所谓“运行 Python 代码”其实是通过配置 build system 调用系统已安装的 python 或 python3 命令来执行脚本。能否成功运行,取决于你的终端能否直接执行 python --version,而不是 Sublime 是否“支持”。
确认 Python 是否在系统 PATH 中
这是最常被跳过的一步,也是 80% 的“运行无反应”“command not found”错误的根源。
- 打开终端(macOS/Linux)或命令提示符/PowerShell(Windows),输入
python --version;如果报错,再试python3 --version - 如果两个都报错,说明 Python 没装,或没加进 PATH —— 此时配 Sublime 的 build system 也没用
- Windows 用户尤其注意:安装 Python 时务必勾选
Add Python to PATH;若已安装但未勾选,重装或手动把 Python 安装目录(如C:\Users\XXX\AppData\Local\Programs\Python\Python311\)加到系统环境变量 PATH 中
创建并保存正确的 Python build system
Sublime 的 build system 是 JSON 格式配置文件,必须放在正确路径、命名规范、语法无误,否则 Ctrl+B 会静默失败或报错 Unable to find target。
- 菜单栏选择
Tools → Build System → New Build System…,粘贴以下内容(根据你终端能用的命令选其一):
{
"shell_cmd": "python -u \"$file\"",
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python"
}
或(如果你只能用 python3):
立即学习“Python免费学习笔记(深入)”;
{
"shell_cmd": "python3 -u \"$file\"",
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python"
}
- 保存为
Python.sublime-build(注意后缀,不是 .json),默认路径是 Sublime 的Packages/User/目录 - 保存后,菜单
Tools → Build System应出现Python选项;务必手动选中它,否则 Sublime 可能沿用旧的(比如 JavaScript)build system
运行时遇到中文乱码或 input() 卡住?
Sublime 的 build panel 是只读输出面板,不提供交互式 stdin 输入能力 —— 所有 input() 调用都会卡住,且 Windows 下 cmd 编码常为 GBK,导致 print 中文显示为 \xe4\xbd\xa0\xe5\xa5\xbd。
- 避免在脚本里写
input();如需调试输入,改用命令行运行:python your_script.py - Windows 用户若 print 中文乱码,可将 build system 改为调用 PowerShell 并指定 UTF-8:
{
"shell_cmd": "powershell -ExecutionPolicy Bypass -Command \"python -u '$file'\"",
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python",
"encoding": "utf-8"
}
- macOS/Linux 用户一般无此问题,但若终端 locale 不是 UTF-8(可用
locale命令检查),也建议在 shell_cmd 前加export LANG=en_US.UTF-8;
为什么 Ctrl+B 后 build panel 没反应、也不报错?
这通常不是 Python 问题,而是 Sublime 的构建机制被静默抑制了 —— 最常见原因有三个:
- 当前文件未保存(
$file是空路径),先按Ctrl+S保存为.py文件 - 文件语法高亮没设为 Python(右下角状态栏应显示
Python;若显示Plain Text,点它 →Set Syntax → Python) - build system 文件名不是
Python.sublime-build,或保存到了错误目录(比如桌面),Sublime 只认Packages/User/下的文件
真正麻烦的地方不在配置,而在于这些细节彼此耦合:PATH 错了,build system 再对也白搭;文件没保存,语法设成 Python 也没用;input() 卡住时,很多人反复重配 build system,其实该换终端跑。


















