Sublime Text需手动配置Python构建系统，否则Ctrl+B报错；须确认Python已安装且在PATH中，再创建支持UTF-8和中文路径的Python3.sublime-build文件，并注意路径、编码与工作目录设置。
Sublime Text 本身不带 Python 运行能力，必须手动配置编译系统（Build System），否则点 Ctrl+B 会提示 “No build system” 或直接报错。
确认 Python 是否已正确安装并可被 Sublime 调用
Sublime 的 Build System 本质是调用系统命令行执行 python 或 python3。如果终端里运行 python --version 报错，或路径不在 PATH 中，Sublime 就找不到解释器。
- Windows 用户：检查是否勾选了安装时的 “Add Python to PATH”，或手动把
Python.exe所在目录（如C:\Users\XXX\AppData\Local\Programs\Python\Python311\）加进系统环境变量PATH - macOS/Linux 用户：运行
which python3，记下输出路径（如/usr/local/bin/python3），后续要填进构建配置 - 别依赖
python命令——很多系统默认指向 Python 2，而你写的是 Python 3 语法，会直接报SyntaxError
创建自定义 Python 构建系统（支持中文、支持 .py 文件自动识别）
Sublime 默认的 Python 构建系统只认 .py 后缀，且不处理中文路径/输出乱码问题。你需要新建一个更鲁棒的 Python3.sublime-build：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
{
"cmd": ["python3", "-u", "$file"],
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python",
"encoding": "utf-8",
"env": {"PYTHONIOENCODING": "utf-8"}
}
-
"cmd"中的-u是关键：强制未缓冲输出，避免 print 不实时刷新 -
"file_regex"让错误行能点击跳转；正则里双引号和反斜杠要转义，否则构建系统加载失败 -
"env"确保子进程继承 UTF-8 编码，否则中文 print 会崩成UnicodeEncodeError - 保存位置：菜单
Tools → Build System → New Build System…，粘贴后保存为Python3.sublime-build，文件会自动存到Packages/User/目录
运行时常见错误及对应解法
即使构建系统写对了，实际按 Ctrl+B 仍可能失败。以下是高频现象和直击要害的修复动作：
立即学习“Python免费学习笔记（深入）”；
-
Unable to find target python3：构建系统里写的python3命令系统找不到——改用绝对路径，比如["/usr/local/bin/python3", "-u", "$file"] - 输出中文变
或报错UnicodeEncodeError: 'gbk' codec can't encode...：说明 Windows 控制台编码是 GBK，但 Python 强制用了 UTF-8 输出——删掉构建系统里的"env"段，改用"cmd": ["cmd", "/c", "chcp 65001 >nul && python3 -u \"$file\""] - 代码没反应、控制台一闪而过：脚本运行完立即退出，看不到输出——在文件末尾加一行
input()（仅调试用），或改用Tools → SublimeREPL → Python → Python（需先装 Package Control 和 SublimeREPL 插件） - 导入自定义模块失败（
ModuleNotFoundError）：Sublime 构建默认工作目录是文件所在目录，不是项目根目录——用"working_dir": "$project_path"显式指定，或改用终端手动 cd 后运行
真正卡住人的往往不是配置步骤，而是 Python 解释器路径、终端编码、工作目录三者之间的隐式耦合。每次改完构建系统，务必重启 Sublime 再试，否则缓存可能导致旧配置仍在生效。
