Sublime Text 配置 Python 环境，推荐使用 Sublime Text 4 搭配 Package Control 安装 SublimeREPL 或 Terminus，配合自建 Build System，十分钟内就能让 F7 直接运行 .py 文件。 这套方案相比 IDE 更轻量，启动速度快，且完全免费,适合日常脚本编写和算法练习。
写 Python 前，Sublime Text 的三大准备工作
在折腾编辑器之前，先把根基打好，很多配置失败，问题往往出在 Python 本身，而不是 Sublime。
第一步：选对 Python 版本并记住安装路径
去 Python 官网下载时，务必勾选“Add Python to PATH”，这一步没做，后面怎么配置都会报“系统找不到指定的路径”，建议安装时选择 Customize installation，把安装路径记下来，行业共识认为，Python 3.8 以上版本对 Sublime Text 4 的兼容性最好。
第二步：验证环境变量是否生效
打开 CMD（Win+R 输入 cmd），输入 python --version 并回车，如果出现版本号，说明环境没问题，如果提示“python 不是内部或外部命令”，需要手动去“系统属性 -> 环境变量 -> Path”中添加 Python 安装目录和 Scripts 子目录。
第三步：核实 Sublime Text 版本
请检查编辑器左下角，确认是 Sublime Text 4（4143 以上版本），老旧的 Sublime Text 3 对 Python 3.10+ 的支持不够完善，插件兼容性也差，如果还在用旧版，建议升级，因为新版内置了对 Apple Silicon 和 Windows ARM 的原生支持。
sublime text配置python环境的完整步骤
先别急着写代码，你需要先装一个插件管理器，再装运行插件,最后配置一键运行。
安装 Package Control 插件管理器
- 按快捷键
Ctrl + Shift + P（Mac 是Cmd + Shift + P）打开命令面板。 - 输入“Install Package Control”并回车。
- 等待数秒，弹出提示即安装完成，如果失败，检查网络连接,尝试设置代理或镜像源。
sublime text安装python插件：推荐这3款
装完 Package Control 后，再次按 Ctrl + Shift + P，输入 “Package Control: Install Package” 回车,搜索以下插件并逐一安装。
| 插件名 | 核心功能 | 适用场景 |
|---|---|---|
| SublimeREPL | 交互式解释器，支持在当前文件目录启动 Python | 需要查看变量类型、逐行调试 |
| Terminus | 在 Sublime 内部打开真正的终端窗口 | 需要支持 input() 交互输入 |
| Anaconda | 代码补全、语法检查、跳转定义 | 写长脚本、需要 IDE 级辅助 |
个人觉得，SublimeREPL 更适合运行脚本查看输出，而 Terminus 则能解决 input() 函数卡死的问题，这两个装一个即可，Anaconda 插件体积较大，如果电脑配置一般,优先推荐前两个。
配置 Build System 实现 F7 一键运行
这是全流程中最核心的操作步骤。
- 点击菜单栏“工具 -> 构建系统 -> 新建构建系统”。
- 会打开一个后缀为
.sublime-build的 JSON 文件。 - 清空原有内容,粘贴以下代码：
{
"cmd": ["python", "-u", "$file"],
"file_regex": "^\sFile "(...?)", line ([0-9])",
"selector": "source.python",
"env": {"PYTHONIOENCODING": "utf-8"}
}
上述代码中的 -u 参数意味着不对 stdout 和 stderr 做缓冲，能保证 print 输出实时显示，添加 PYTHONIOENCODING 环境变量是为了避免控制台打印中文时出现 UnicodeEncodeError。
- 按
Ctrl + S保存，文件名随意，Python3.sublime-build。 - 现在打开任意
.py文件，按 Ctrl + B 即可运行。
配置虚拟环境（venv）路径以加载第三方库
如果你使用虚拟环境，需要把 cmd 中的 python 替换为虚拟环境中的绝对路径。
{
"cmd": ["D:/MyProject/venv/Scripts/python.exe", "-u", "$file"],
"selector": "source.python"
}
这样配置后，按下 Ctrl + B 就会使用虚拟环境中的解释器来运行代码，项目中安装的 requests、pandas 等库就能正常 import 了，有网友在技术社区反馈，很多人在这一步卡住，主要原因是在虚拟环境中使用了全局环境的 Python。
真正能跑起来的运行方案：处理常见的坑
配置完成后，优先测试最简单的 print(“Hello World”) 并大胆验证，如果按 Ctrl + B 无反应或报错,按以下顺序排查。
F7 没反应？检查文件名后缀和 Build System
- 确认文件保存为
.py后缀。 - 确认“工具 -> 构建系统”里勾选了你刚刚创建的 Python3。
- 确认 CMD 中手动输入
python能正常进入交互模式。
代码有中文却报错？解决编码问题
在文件第一行加入 # -- coding: utf-8 --，如果仍然报错，大概率是使用了 Windows 默认的 GBK 编码，只需要按 Ctrl + Shift + P 输入 Set Syntax: Python 重新关联一下语法，或者在文件右下角点击“UTF-8”重新以 UTF-8 编码保存。
遇到 sublime配置python时常见报错：找不到模块不是编辑器问题
多数情况下，报 ModuleNotFoundError 是因为你用 pip 安装了库，但是在 Sublime 的 Build System 里用的是另一个 Python 解释器，在 Sublime 的新建构建系统中，直接写死绝对路径是最稳妥的方案，这里建议使用 where python 命令来确认当前系统默认的 Python 解释器位置。
Sublime Text 与 VS Code 的权衡
很多人会在探究 sublime配置python怎么做时产生疑问：sublime和vscode哪个写python好？这需要从不同人群的实际需求来拆解。
轻量极速需求：Sublime Text 更占优
如果你需要的是一个打开即写、不卡顿的编辑器，Sublime 明显更占优。它的启动速度在 1 秒以内，内存占用通常在 100MB 左右，反观 VS Code，每次启动都需要加载扩展，加上插件后内存开销接近 500MB 级别，对于快速修改脚本、处理大日志文件，Sublime 还是更从容。
工程化与调试功能：VS Code 依然领先
如果你要写 Django 后端框架或者使用 Jupyter Notebook 做交互式数据分析，VS Code 内置的调试器（Debugger）和智能感知（IntelliSense）完全碾压 Sublime，Sublime 中的调试需要配置 debugpy 插件，且配置过程相对繁琐，行业评估认为，Sublime 适合“写代码”，VS Code 适合“改项目”。
Sublime 的差异化优势：Go To Anything 与多光标
这在两个编辑器对比中容易被忽视，按 Ctrl + P 输入文件名即可跳转，按 Ctrl + D 选择相同词，这两个操作在快速重构大文件时效率极高，VS Code 虽然也有类似功能，但 Sublime 的灵敏度是业界出了名的快。
Sublime 的价格和付费问题
顺便聊一下价格，Sublime 采用 免费无限期试用策略，只是偶尔弹出购买提醒，不强制付费，对于学生和轻量使用者来说，相当于免费，VS Code 则是完全开源免费，这一点两者打平，不过国内使用 VS Code 常常需要切换下载源，而 Sublime 的官方 English 网站在国内访问通常较慢为了辅助阅读，建议使用翻译插件或镜像站，不过只要配置好了，Sublime 的运行环境关联性更强。
把 Sublime 打造成适合中文用户的轻量 IDE
以下操作是基于日常使用的优化配置，有更强的针对性,适合复制到自己的配置中。
调整界面和字体
安装 ChineseLocalizations 插件，即可将菜单切换为简体中文，设置里调整字体为“Consolas”或“JetBrains Mono”，字号设置 14 或者 16,美观程度上比默认字体好很多。
多文件运行与恍行路径的处理
如果想要配置“在当前文件所在目录运行”,构建系统可以写为：
{
"cmd": ["python", "-u", "$file"],
"working_dir": "${file_path}",
"selector": "source.python"
}
这意味着当文件路径包含不存在的文件夹或空格时，系统也不会报错,代码能正常访问相对路径下的资源文件。
Sublime配置python常见问题速查
为什么按了 Ctrl + B 之后，控制台只闪现一个黑色窗口就消失了？
这是 Windows 系统的典型现象，说明 Python 进程执行完毕，且窗口无法自动驻留，解决方法是，在代码末尾加上 input() 函数，这样程序会等待输入再关闭窗口，确保构建系统配置了 "variants"，并使用 "freya"（Terminus）作为运行终端，这样能规避原先 cmd 弹出后迅速消失的问题,输出结果也不会丢失。
怎么让 Sublime 配置的 Python 环境指向 Anaconda？
安装 Anaconda 后，打开 CMD 输入 conda env list 查看虚拟环境路径，然后在构建系统中，将 "cmd" 里的 python 改为你想要的解释器绝对路径即可，如果你想使用名为 research 的环境，那么解释器路径就是类似 C:Users用户名anaconda3envsresearchpython.exe 的形式，改完以后记得保存，然后就可以在 Sublime 里直接运行深度学习相关的包，而很多人在配置环境时不指定绝对路径，却希望 Sublime 能找到 Conda 环境里的库,这显然是行不通的。
Sublime 配置 Python 并没有想象中复杂，核心思路就是明确解释器路径、选对运行终端插件、处理编码问题，把这三件事做好，即使不配置任何炫酷的语法高亮主题，你也能拥有一个秒开、无广告、专注码字的 Python 轻量开发环境。