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

首页

编程语言

热心网友

转载

2026-05-02

Sublime Text 运行 Python 全攻略：从环境配置到解决乱码与卡顿问题

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

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

许多开发者误以为 Sublime Text 能够“一键运行”Python 脚本，实际上它本身并不包含 Python 解释器。其运行机制是通过配置一个构建系统（build system），来调用系统中已安装的python或python3解释器命令。因此，成功运行的关键在于确保系统环境配置正确，而非编辑器本身。

第一步：验证系统 Python 环境与 PATH 配置

这是最基础也是最关键的一步。超过80%的“运行无响应”或“命令未找到”错误，根源都在于系统环境变量 PATH 未正确配置。

验证方法非常简单：

打开系统终端（macOS/Linux）或命令提示符/PowerShell（Windows），直接输入命令python --version。
如果提示错误，请尝试输入python3 --version。

如果两个命令均无法识别，则意味着 Python 未安装，或者其安装路径未被添加到系统的 PATH 环境变量中。在此情况下，后续的 Sublime Text 配置均无法生效。

特别提醒 Windows 用户：在安装 Python 时，请务必勾选Add Python to PATH选项。如果已安装但忘记勾选，解决方案是重新安装或手动将 Python 安装目录（例如C:\Program Files\Python311\或C:\Users\[用户名]\AppData\Local\Programs\Python\Python311\）添加到系统环境变量 PATH 中。

第二步：创建并配置正确的 Python 构建系统文件

确认系统环境无误后，即可在 Sublime Text 中配置构建系统。该配置是一个 JSON 格式的文件，必须确保其命名、存放路径和语法完全正确，否则按下 Ctrl+B 可能无响应或报错。

详细配置步骤如下：

在 Sublime Text 菜单栏中，依次选择工具（Tools） → 构建系统（Build System） → 新建构建系统（New Build System…）。
根据你系统中实际生效的 Python 命令，将下方对应的配置代码粘贴到新文件中。

若系统命令为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（注意后缀名）。Sublime Text 通常会默认将其保存到正确的Packages/User/目录下，请勿更改此路径。
保存后，再次点击菜单Tools → Build System，你将看到新增的Python选项。请务必手动选中它，以确保 Sublime Text 使用正确的构建系统。

第三步：解决运行中的常见问题（中文乱码与 input() 卡住）

成功运行后，可能会遇到两个典型问题：交互输入卡死和中文输出乱码。这是因为 Sublime Text 的构建面板（Build Panel）是一个只读输出窗口，不支持交互式输入。

解决方案如下：

规避 input() 函数：如果你的脚本需要用户输入，建议直接在系统终端中使用python your_script.py命令运行，以获得完整的交互体验。
解决 Windows 中文乱码问题：Windows 命令提示符默认编码为 GBK，与 UTF-8 编码的 Python 脚本不匹配。可修改构建系统配置，改用 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命令检查编码，或在shell_cmd前添加export LANG=en_US.UTF-8; 来强制使用 UTF-8 编码。

第四步：高级排查：Ctrl+B 无响应且不报错的处理方法

有时配置看似无误，但按下 Ctrl+B 后构建面板毫无反应。这通常是由于 Sublime Text 的构建流程被某些条件静默中断。请按顺序排查以下三点：

文件未保存：构建系统依赖当前文件的完整路径。如果文件从未保存，路径为空，则无法执行。请先按Ctrl+S将文件保存为.py格式。
语法未正确设置：检查编辑器右下角状态栏，确保显示为Python。若显示Plain Text，请点击并选择Set Syntax → Python。
构建系统文件路径错误：确认Python.sublime-build文件确实位于Packages/User/目录中。若误存至其他位置，Sublime Text 将无法识别。