Sublime Text 找不到 python3 是因未正确配置 Build System 路径;需先用 which/python3 或 where python3 查实路径,再在 New Build System 中写死绝对路径并保存为 Python3.sublime-build。

Sublime Text 找不到 python3 命令?先查路径再配
Sublime Text 本身不内置 Python 解释器,运行 Python 文件时依赖系统 PATH 中的 python3(或 python)命令。如果点 Ctrl+B 报错 Unable to find python3 in PATH 或直接闪退,说明它根本没找到可执行文件。
别急着改 Sublime 设置——先在终端确认真实路径:
- macOS/Linux:运行
which python3,常见返回如/usr/local/bin/python3或/opt/homebrew/bin/python3 - Windows:打开 CMD,运行
where python3,可能返回C:\Users\XXX\AppData\Local\Programs\Python\Python311\python.exe
拿到路径后,才进下一步;否则配了也白配。
Build System 配置里写死 python3 路径最稳
Sublime 的 Build System 是纯 JSON,不支持环境变量展开(比如 $PATH 或 %USERPROFILE%),所以不能写 "cmd": ["python3", "$file"] 期望它自动 resolve——它只认绝对路径。
立即学习“Python免费学习笔记(深入)”;
操作步骤:
- 菜单栏 → Tools → Build System → New Build System…
- 替换全部内容为以下(按你查到的实际路径修改):
{
"cmd": ["/usr/local/bin/python3", "-u", "$file"],
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python",
"encoding": "utf-8"
}
注意:-u 强制未缓冲输出,避免 print 不实时;"selector": "source.python" 确保只对 .py 文件生效;Windows 用户把路径换成双反斜杠或正斜杠,例如 "cmd": ["C:/Users/XXX/AppData/Local/Programs/Python/Python311/python.exe", "-u", "$file"]。
为什么改了 PATH 也没用?Sublime 不读 shell 的 ~/.zshrc
你在终端能跑 python3,不代表 Sublime 能——因为它通常不是从 shell 启动的(比如 macOS 从 Spotlight 或 Dock 启动),不会加载 ~/.zshrc 或 ~/.bash_profile 里的 export PATH=...。
验证方法:在 Sublime 里按 Ctrl+` 打开内置终端(如果有插件),或者用 Python 控制台执行:
import os; print(os.environ.get('PATH'))
你会发现输出里根本没有你加的 Python 路径。所以靠“改 shell 配置”来修复 Sublime 的 Python 调用,基本无效。
可靠解法只有两个:
- 用上面说的 Build System 写死路径(推荐)
- macOS 用户可改用
open -a "Sublime Text"从终端启动,这样会继承 shell 环境(但每次都要终端敲命令,不现实)
python 和 python3 混用容易出兼容问题
有些系统(尤其旧版 macOS 或某些 Linux 发行版)默认 python 指向 Python 2.7,而 python3 才是你要的。如果 Build System 里写的是 python,却没意识到当前是 2.7,代码里用了 f-string 或 print() 函数语法,就会报错。
检查方法很简单:在 Sublime 的 Build System 里临时加一行 "cmd": ["/usr/local/bin/python3", "--version"],运行看输出是不是 Python 3.x.x。
更稳妥的做法是:始终明确用 python3,并确保路径指向你 pip3 install 包的那个解释器(比如用 pyenv 管理多版本时,路径可能是 ~/.pyenv/versions/3.11.5/bin/python3)。
路径不对、版本混淆、shell 环境不继承——这三个点卡住的人最多。配完记得保存为 Python3.sublime-build,然后在 Tools → Build System 里选它,而不是默认的 Python。











