sublime text 需配置 python3.sublime-build 文件调用系统已安装的 python3 可执行文件;须先确认 python3 在 path 中,再创建含正确绝对路径和 -u 参数的构建系统,保存至 user 包并手动切换使用。

Sublime Text 本身不自带 Python 运行环境,它只是个编辑器;所谓“安装 Python3 环境”,实际是配置 sublime-build 文件,让 Sublime 能调用你系统里已安装的 python3 可执行文件来运行代码。
确认系统已安装 Python3 并在 PATH 中
这是最关键的前置条件。Sublime 不会帮你装 Python,只负责调用。
- 终端运行
which python3(macOS/Linux)或where python3(Windows),确认有输出路径,比如/usr/local/bin/python3或C:UsersXXXAppDataLocalProgramsPythonPython311python.exe - 如果报错“command not found”,说明 Python3 没装或没加进系统 PATH,得先去官网下载安装,并勾选 “Add Python to PATH”(Windows)或手动配置 shell profile(macOS/Linux)
- 别用
python命令测试——它可能指向 Python2,python3才是明确版本标识
创建或修改 Python3.sublime-build 文件
这个文件告诉 Sublime:按什么命令、带什么参数去执行当前 .py 文件。
- 菜单栏 → Tools → Build System → New Build System…,会打开一个空白
sublime-build文件 - 替换成以下内容(注意替换
cmd中的路径为你自己的python3实际路径):
{
"shell_cmd": "/usr/local/bin/python3 -u "$file"",
"file_regex": "^[ ]*File "(...*?)", line ([0-9]*)",
"selector": "source.python"
}
- Windows 用户把
shell_cmd改成类似:"cmd": ["C:\Users\XXX\AppData\Local\Programs\Python\Python311\python.exe", "-u", "$file"](注意双反斜杠或正斜杠均可,但不能混用) -
-u参数很重要:强制未缓冲输出,否则 print() 可能卡住不刷新 - 保存为
Python3.sublime-build,默认位置是~/Library/Application Support/Sublime Text/Packages/User/(macOS)或%APPDATA%Sublime TextPackagesUser(Windows)
切换 Python 版本:不是换解释器,而是换 build system
Sublime 没有全局“Python 版本设置”,每次运行都取决于当前激活的 build system。
立即学习“Python免费学习笔记(深入)”;
- 写完 .py 文件后,按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入Build With: Python3回车,就临时切到你刚建的 Python3 构建系统 - 也可以菜单栏 → Tools → Build System → Python3 手动切换,之后所有
Ctrl+B都走这个配置 - 如果同时有
Python2.sublime-build和Python3.sublime-build,它们完全独立,互不影响——本质就是两套不同的命令行调用 - 别指望在 Sublime 里用
#!/usr/bin/env python3注释自动切换版本,它不起作用;Sublime 不解析 shebang
真正容易被忽略的是:build system 中的路径必须绝对准确,且对应可执行文件有执行权限(Linux/macOS 下常见问题)。哪怕多一个空格、少一个引号,或者用了中文路径,Ctrl+B 都只会静默失败——连错误提示都不给。建议先在终端里手动跑一遍同样的命令验证是否可行。










