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
看清楚错误信息到底在说什么
报错分三类,处理方式不同:
立即学习“Python免费学习笔记(深入)”;
- 语法错误(SyntaxError):比如少括号、冒号、缩进混乱——这是代码问题,Sublime 的侧边栏或底部状态栏会标出行号,直接跳过去改
- 模块导入失败(ModuleNotFoundError / ImportError):说明你用了第三方库(如 requests),但没用 pip 安装,或装在了 Sublime 没法访问的 Python 环境里(比如虚拟环境没激活)
- 权限/路径错误(PermissionError / FileNotFoundError):常见于读写文件时路径写错,或脚本试图访问被系统限制的目录
小技巧:临时验证是否是 Sublime 配置问题
用最简代码测试,排除干扰:
print("Hello, Sublime!")
- 保存为
test.py,Ctrl+B 运行 - 如果这个都报错,基本确定是构建系统或 Python 环境问题
- 如果它成功,再逐步加回你原来的代码,定位哪一行触发异常
基本上就这些。不用折腾插件或复杂设置,先把基础跑通,再谈优化。常见问题往往出在“以为装了 Python,其实没加路径”或者“用 python3 写的代码却让 Sublime 调 python”。











