sublime text 配置 python 环境本质是让 build system 正确调用本地已安装的 python3 可执行文件：先在终端运行 which python3（macos/linux）或 where python（windows）确认真实路径，再新建 .sublime-build 文件，shell_cmd 中填绝对路径并加 -u 参数，保存为 python3.sublime-build 即可一键运行。
Sublime Text 本身不自带 Python 运行环境，所谓“配置 Python 环境”，本质是让 Build System 正确调用你本地已安装的 python 或 python3 可执行文件——不是装插件、不是改 PATH，而是告诉 Sublime：“该用哪个命令来跑我写的 .py 文件”。
确认本地 Python 是否可用且路径清晰
这是最常被跳过的一步。很多人直接配 Build System 却失败，根本原因是 which python3（macOS/Linux）或 where python（Windows）返回空，或返回了虚拟环境里的路径（比如 venv/bin/python），而该环境未激活。
- 在终端里运行
python3 --version，确保有输出；没有就先装 Python（推荐从 python.org 下载） - 运行
which python3（macOS/Linux）或where python（Windows CMD），记下完整路径，例如/usr/local/bin/python3或C:UsersAliceAppDataLocalProgramsPythonPython311python.exe - 别依赖
python命令——很多系统里它指向 Python 2，而你写的是 Python 3 语法，会报SyntaxError: invalid syntax
手动创建 Python3 Build System（推荐）
Sublime 的默认 Python Build System 是硬编码调用 python，不可靠。你需要一个显式指定解释器路径的 .sublime-build 文件。
- 菜单栏选择 Tools → Build System → New Build System…
- 替换全部内容为以下 JSON（注意把
cmd中的路径换成你上一步查到的真实路径）：
{
"shell_cmd": "/usr/local/bin/python3 -u "$file"",
"file_regex": "^[ ]*File "(...*?)", line ([0-9]*)",
"selector": "source.python"
}
- 保存为
Python3.sublime-build（文件名必须以.sublime-build结尾） - 之后在 Tools → Build System 下就能选中它；快捷键
Ctrl+B（Windows/Linux）或Cmd+B（macOS）即可运行当前文件 -
-u参数很重要：禁用输出缓冲，否则print()不会实时显示，调试时卡住
遇到 “Unable to find python” 或闪退怎么办
这类错误几乎全是路径问题，和 Sublime 版本、插件无关。
- 检查
shell_cmd里的路径是否拼错，尤其 Windows 用户注意反斜杠要双写："C:\Python311\python.exe"，单写P会被当转义符 - 如果用了虚拟环境，不要把
venv/bin/python写进 Build System——它依赖激活状态；要么用全局 Python，要么在终端里手动激活后用python -m py_compile xxx.py测试 - Mac 用户若用 Homebrew 安装 Python，路径通常是
/opt/homebrew/bin/python3（Apple Silicon）或/usr/local/bin/python3（Intel），别用/usr/bin/python3（那是系统自带的，可能被禁用） - Build System 保存后没生效？重启 Sublime，或在命令面板（
Ctrl+Shift+P）输入 Reload Projects
不需要插件，但可以加个实用小技巧
Sublime 没有交互式终端，但你可以快速打开系统终端并定位到当前文件所在目录：
- 安装
Terminal插件（通过 Package Control），它不改构建逻辑，只加一个右键菜单项 Open Terminal Here - 或者更轻量：用
Tools → Build System → New Build System…创建一个纯终端启动的 Build：
{
"shell_cmd": "open -a Terminal .",
"working_dir": "$file_path"
}
- 保存为
OpenInTerminal.sublime-build，按Ctrl+B就能一键唤起终端并 cd 到当前文件夹，适合手动运行带参数的脚本或调试
真正卡住人的从来不是 Sublime 多难配，而是把“Python 路径”当成黑盒——它就在你终端里，敲一行命令就能看见。配完记得删掉默认的 Python Build System，避免误选。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
