Sublime Text如何运行Python代码_Sublime Text运行Python脚本教程【总结】

Sublime Text 运行 Python 依赖系统 PATH 中的 python/python3 命令，需先验证终端可执行 python --version；再配置正确命名（Python.sublime-build）、存放于 Packages/User/ 的 build system；避免 input() 并注意编码问题。

很多朋友误以为Sublime Text能“直接”运行Python，其实不然。它本身并不内置Python解释器。所谓的运行，本质上是通过配置一个build system，来调用你系统里已经安装好的python或python3命令。所以，问题的关键不在于编辑器，而在于你的系统环境是否就绪。

确认 Python 是否在系统 PATH 中

这一步看似基础，却拦住了绝大多数人。超过八成的“运行没反应”或“command not found”错误，根源都在这里。

怎么验证？方法很简单：

• 打开你的终端（macOS/Linux）或者命令提示符/PowerShell（Windows），直接输入python --version试试看。
• 如果报错，别急，再试试python3 --version。

如果两个命令都找不到，那就说明要么Python根本没安装，要么安装时没被添加到系统的PATH环境变量里。这种情况下，你在Sublime里配置任何东西都是徒劳。

这里尤其要提醒Windows用户：安装Python时，那个Add Python to PATH的复选框，务必勾选上。如果已经安装但当时忘了勾选，解决办法要么是重装一遍，要么就是手动把Python的安装目录（比如C:\Users\XXX\AppData\Local\Programs\Python\Python311\）添加到系统的环境变量PATH中。

创建并保存正确的 Python build system

环境没问题了，接下来就是给Sublime Text配置“构建系统”。这个配置其实是一个JSON格式的文件，必须放在正确的路径、使用正确的命名，并且语法无误。任何一步出错，按下Ctrl+B都可能静默失败，或者弹出Unable to find target这样的错误。

具体操作流程如下：

• 在Sublime Text的菜单栏，依次选择Tools → Build System → New Build System…。
• 然后，根据你终端里实际可用的命令，将下面两段代码之一粘贴进去：

如果你的系统命令是python：

{
    "shell_cmd": "python -u \"$file\"",
    "file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
    "selector": "source.python"
}

或者，如果你的系统命令是python3：

{
    "shell_cmd": "python3 -u \"$file\"",
    "file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
    "selector": "source.python"
}

• 接下来是关键一步：保存文件。文件名必须是Python.sublime-build（注意后缀名，不是.json）。Sublime Text通常会默认保存到正确的Packages/User/目录下，不要随意更改路径。
• 保存成功后，再次点击菜单Tools → Build System，你应该能看到新增的Python选项。记得手动选中它，否则Sublime可能还会沿用之前其他语言的构建系统。

运行时遇到中文乱码或 input() 卡住？

代码能跑了，但新问题又来了。Sublime Text下方的构建面板（build panel）本质上是一个只读的输出区域，它并不提供交互式的输入功能。这意味着，一旦你的脚本里调用了input()，程序就会卡在那里等待输入，而你却无法输入任何内容。

此外，在Windows系统下，命令提示符（cmd）的默认编码通常是GBK，而Python脚本若以UTF-8编码保存，打印中文字符时就很容易出现像\xe4\xbd\xa0\xe5\xa5\xbd这样的乱码。

解决办法其实很明确：

• 避免使用input()：如果脚本只是为了测试或学习，需要用到输入功能，建议直接打开终端，用python your_script.py这样的命令来运行。
• 解决Windows中文乱码：可以修改构建系统的配置，改为调用PowerShell并强制使用UTF-8编码。将之前的配置替换为如下内容：

{
    "shell_cmd": "powershell -ExecutionPolicy Bypass -Command \"python -u '$file'\"",
    "file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
    "selector": "source.python",
    "encoding": "utf-8"
}

• macOS/Linux用户：通常没有编码问题，但如果你的终端locale设置不是UTF-8（可以用locale命令检查），也可以在shell_cmd前面加上export LANG=en_US.UTF-8; 来确保编码一致。

为什么 Ctrl+B 后 build panel 没反应、也不报错？

有时候，一切配置看似正确，但按下Ctrl+B后，构建面板就是毫无动静，也不给任何错误提示。这通常不是Python的锅，而是Sublime Text自身的构建机制被某些条件“静默”抑制了。最常见的原因有三个，可以按顺序排查：

• 文件未保存：构建系统里的$file变量指向当前文件路径。如果文件从未保存过，这个路径就是空的，自然无法执行。先按Ctrl+S，把文件保存为一个.py文件。
• 语法未设置：看看编辑器右下角的状态栏，是否显示为Python？如果显示的是Plain Text，Sublime可能不知道用哪个构建系统。点击它，选择Set Syntax → Python。
• 构建系统文件放错了地方：确认你保存的Python.sublime-build文件确实在Packages/User/目录下。如果误存到了桌面或其他地方，Sublime是找不到的。

说到底，配置Sublime Text运行Python的难点，往往不在于某个单一步骤，而在于这些环节彼此关联、环环相扣。系统PATH不对，构建系统配得再完美也无用武之地；文件没保存，语法设置对了也白搭；遇到input()卡住，反复折腾构建系统不如直接打开终端。理清这个逻辑链条，解决问题就能有的放矢了。