sublime text 运行 python 报错“找不到 python”是因为它不读系统 path,需在 .sublime-build 中写死 python 解释器绝对路径,并确保含 "-u" 和 "$file";虚拟环境需用其内 python 路径;文件须保存为 python3.sublime-build 至 packages/user/ 目录并手动启用。

Sublime Text 运行 Python 报错“找不到 python”或“Unable to find python command”,不是它坏了,而是它压根没看到你的 Python 解释器——它不读系统 PATH,也不继承 shell 环境变量,只认你写死在 .sublime-build 里的绝对路径。
查不到 python3 路径?先确认终端里真能跑
别凭记忆填路径。终端里执行命令,拿到结果就粘贴:
- macOS/Linux:
which python3(不是python),常见输出如/opt/homebrew/bin/python3或/Users/you/.pyenv/versions/3.12.1/bin/python - Windows:
where python3(推荐用 PowerShell),选带Python312的那条,比如C:\Users\Alice\AppData\Local\Programs\Python\Python312\python.exe - 如果没输出,说明 Python 没装好或根本没加进系统环境变量——这时修 PATH 才是第一步,不是改 Sublime
cmd 字段必须写死绝对路径,且不能漏 -u
新建 Build System(Tools → Build System → New Build System…)后,JSON 必须包含这三项核心内容:
-
"cmd"数组第一项:解释器**绝对路径**,Windows 含空格时整个路径用双引号包裹,例如"C:/Program Files/Python312/python.exe"(推荐正斜杠,避免反斜杠转义问题) - 第二项固定为
"-u":禁用 stdout 缓冲,否则print()不刷新、input()直接卡住 - 第三项必须是
"$file":表示当前打开的.py文件,不能写成"main.py"或漏掉
完整示例(macOS):
{
"cmd": ["/opt/homebrew/bin/python3", "-u", "$file"],
"selector": "source.python",
"encoding": "utf-8"
}
用了虚拟环境却 import 失败?Build System 指向错了
你在终端激活了 venv 并 pip install requests 成功,但 Sublime 里 import requests 报 ModuleNotFoundError——99% 是因为构建系统还在调用全局 Python。
- 先激活环境:
source venv/bin/activate(macOS/Linux)或venv\Scripts\activate.bat(Windows) - 再运行
which python(macOS/Linux)或where python(Windows),拿到类似./venv/bin/python或.\venv\Scripts\python.exe的路径 - 把这个路径填进
"cmd"第一项,而不是系统默认的/usr/bin/python3或C:\Python312\python.exe - 别信“Anaconda 插件自动识别”——它的
python_interpreter配置必须和 Build System 的"cmd"路径完全一致,否则两套环境打架
保存命名和启用细节决定成败
建完文件后容易忽略几个硬性条件:
- 文件名必须以
.sublime-build结尾,推荐命名为Python3.sublime-build(不是Python312或MyPython) - 必须保存到
Packages/User/目录下(可通过Preferences → Browse Packages进入) - 保存后,手动点
Tools → Build System → Python3选中它;状态栏右下角要显示 “Python3”,否则 Ctrl+B 仍走默认配置 - 确保当前文件是
.py后缀,且右下角语法高亮显示为 “Python”(不是 Plain Text)
最常被跳过的其实是最后一点:路径对了、-u 有了、文件也保存了,但状态栏没切到新构建系统——Ctrl+B 就永远静默。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











