Sublime编译Python脚本出错解决方法

Sublime Text 编译 Python 报错通常源于环境、配置或代码问题。先确认 Python 已安装并加入系统 PATH；再检查构建系统是否匹配 Python 版本（如用 python3 需配置对应 build 文件）；最后根据错误类型（语法、模块导入、权限/路径）精准定位修复。

Sublime Text 编译 Python 脚本报错，通常不是 Sublime 本身的问题，而是环境、配置或代码层面出了状况。先别急着重装，按下面几步排查，90% 的情况能快速解决。

检查 Python 是否已正确安装并加入系统路径

Sublime 默认调用的是系统命令行里的 python 或 python3。如果终端里输入 python --version 报“命令未找到”，那 Sublime 肯定也找不到。

• 在终端（macOS/Linux）或命令提示符（Windows）中运行 python --version 或 python3 --version，确认有输出
• 没有输出？去 python.org 下载安装最新版，并勾选 “Add Python to PATH”（Windows）或手动配置 PATH（macOS/Linux）
• 装完后重启 Sublime，再试运行

确认 Sublime 使用的构建系统是否匹配你的 Python 版本

Sublime 默认的 Python 构建系统可能调用的是 python，但你装的是 python3（尤其是 macOS 或 Linux），就会报 “command not found”。

• 菜单栏点 Tools → Build System → New Build System…
• 替换成以下内容（适配 python3）：

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

• 保存为 Python3.sublime-build，然后在 Build System 中选它
• Windows 用户若用的是 python 命令，可把上面的 python3 改成 python

看清楚错误信息到底在说什么

报错分三类，处理方式不同：

• 语法错误（SyntaxError）：比如少括号、冒号、缩进混乱——这是代码问题，Sublime 的侧边栏或底部状态栏会标出行号，直接跳过去改
• 模块导入失败（ModuleNotFoundError / ImportError）：说明你用了第三方库（如 requests），但没用 pip 安装，或装在了 Sublime 没法访问的 Python 环境里（比如虚拟环境没激活）
• 权限/路径错误（PermissionError / FileNotFoundError）：常见于读写文件时路径写错，或脚本试图访问被系统限制的目录

小技巧：临时验证是否是 Sublime 配置问题

用最简代码测试，排除干扰：

print("Hello, Sublime!")

• 保存为 test.py，Ctrl+B 运行
• 如果这个都报错，基本确定是构建系统或 Python 环境问题
• 如果它成功，再逐步加回你原来的代码，定位哪一行触发异常

基本上就这些。不用折腾插件或复杂设置，先把基础跑通，再谈优化。常见问题往往出在“以为装了 Python，其实没加路径”或者“用 python3 写的代码却让 Sublime 调 python”。