如何用Sublime运行Python代码？Sublime搭建Python环境配置手册

Sublime Text需手动配置Build System才能运行Python：必须用绝对路径指定python解释器、加-u参数禁用缓冲、含"$file"动态传入当前文件，否则Ctrl+B报错或无响应。

先说一个核心事实：Sublime Text本身并不自带Python解释器。这意味着，如果你直接按下Ctrl+B，大概率会遇到“python” is not recognized的错误提示，或者干脆毫无反应。它并非不能运行Python，而是必须经过手动配置构建系统这一步。

Build System 配置：路径、-u、$file 缺一不可

配置构建系统，本质上就是告诉Sublime Text：“去这里找Python程序，然后运行我当前打开的这个文件。”听起来简单，但有几个细节堪称“魔鬼”，一步错就步步错。

• 绝对路径是硬性要求：“cmd”字段里必须填写解释器的完整路径。在Windows上，你得写类似“C:/Python311/python.exe”（使用正斜杠）或“C:\\Python311\\python.exe”（使用双反斜杠）的格式。直接写个“python”是行不通的——除非你确信系统环境变量PATH已全局配置好，并且在终端里输入python --version能立刻得到响应。
• 别忘了“-u”参数：这个参数的作用是禁用输出缓冲。不加它的话，print()语句的输出可能会延迟显示，甚至在你程序需要输入（input()）时，整个进程会莫名其妙地卡住，让人摸不着头脑。
• “$file”是动态关键：这个变量代表当前打开的.py文件路径，Sublime Text会自动替换它。你既不能把它写成某个固定的硬盘路径，也不能漏掉。当然，前提是Sublime Text正确识别了你的文件类型（即文件后缀是.py，且语法高亮已设置为Python）。
• 多版本Python的应对策略：对于安装了多个Python版本的Windows用户，可以尝试使用系统自带的py启动器，比如将路径替换为[“py”, “-3.11”, “-u”, “$file”]。不过，这需要先验证py -3.11 --version在命令提示符中能正常工作。

虚拟环境支持：别让 import 报 ModuleNotFoundError

你是否遇到过这种情况：在终端里用pip install requests安装包一切顺利，但回到Sublime Text里import requests却提示找不到模块？问题根源往往在于，你的构建系统指向的是系统全局的Python解释器，而不是项目专属的虚拟环境。

• 找到真正的解释器路径：首先，激活你的项目虚拟环境（例如通过source venv/bin/activate或conda activate myenv）。然后，在终端运行which python（macOS/Linux）或where python（Windows），获取到的那个路径，才是你需要的。
• 针对性配置构建系统：把上面得到的路径填进Build System的“cmd”字段，例如[“/path/to/project/venv/bin/python”, “-u”, “$file”]。一个最佳实践是：为每个使用独立虚拟环境的项目，单独创建一个Build System配置文件（可以命名为Python - myproject.sublime-build），这样可以彻底避免依赖冲突。
• 明确一个认知：不要指望Sublime Text能自动“嗅探”或“进入”虚拟环境。它不具备shell的上下文环境，一切都需要你明确指定。

插件不是必须，但 Anaconda 能解决补全和跳转失效

原生状态的Sublime Text对Python的支持几乎为零：没有代码补全，无法跳转到定义，也不会检查简单的拼写错误。这时候，插件就派上用场了。其中，Anaconda插件是经过时间检验的稳定选择，不过它的配置也有门道。

立即学习“Python免费学习笔记（深入）”；

• 关键一步：指定解释器：安装Anaconda插件后，必须手动进行配置。进入Preferences → Package Settings → Anaconda → Settings - User，找到并设置“python_interpreter”项。这里填写的路径，必须和你的Build System里使用的解释器路径完全一致，否则补全功能依然找不到已安装的包。
• 解决跨目录导入问题：如果你遇到跨目录import失效，可以在项目根目录下创建一个空的.jedi文件（Anaconda兼容Jedi的配置）。文件内容可以这样写：{“sys_path”: [“./src”, “./lib”]}，以此来明确告知插件额外的模块搜索路径。
• 按需选择：如果你的工作只是编写和运行独立脚本，不涉及复杂的包结构和代码导航，那么完全可以跳过插件。只要Ctrl+B能正确运行代码，补全和跳转可以依赖其他IDE或记忆。
• 插件二选一：值得注意的是，Anaconda和另一个现代插件LSP-Python-MS可能存在冲突，二者选其一即可。后者功能更强大但配置也相对复杂一些。

最后，分享一个最容易被忽略却至关重要的细节：文件保存状态。Sublime Text中的$file变量指向的是“已保存到磁盘的文件路径”。如果你编写了新代码却没有按Ctrl+S保存，那么按下Ctrl+B时，运行的将是硬盘上旧的版本，甚至可能报错“文件不存在”。所以，运行前务必先保存，这应该成为一个肌肉记忆。