需手动配置Python构建系统并确保文件后缀为.py、语法设为Python；自定义Python3构建系统支持input交互，避免中文路径，推荐Anaconda和EditorConfig插件。
如何让 Sublime Text 正确识别并运行 Python 文件
Sublime Text 默认不绑定 Python 构建系统，直接按 Ctrl+B（Windows/Linux）或 Cmd+B（macOS）会报错 No build system 或执行系统默认的空构建。关键不是装插件，而是配对「文件类型识别」+「构建系统路径」。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 保存文件时务必用
.py后缀，否则 Sublime 不会自动切换语法高亮和构建上下文 - 通过菜单
View → Syntax → Python手动确认当前语法为 Python（右下角应显示Python），避免因文件名不含.py或被误设为 Plain Text 导致构建失败 - 检查 Python 是否在系统 PATH 中：终端运行
which python3（macOS/Linux）或where python（Windows），复制输出路径，后续构建系统要用到
配置 Python3 构建系统（支持 print 输出、input 输入）
Sublime 的 Python 默认构建系统（Tools → Build System → Python）只适用于 Python 2，且不支持 input() 交互——它跑在 Sublime 内置的非终端环境中，标准输入被禁用。必须自定义一个调用系统终端的构建系统。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 菜单打开
Tools → Build System → New Build System…，粘贴以下内容（以 macOS/Linux 为例）：
{
"shell_cmd": "python3 -u "$file"",
"file_regex": "^[ ]*File "(...*?)", line ([0-9]*)",
"selector": "source.python",
"variants": [
{
"name": "Run in Terminal",
"shell_cmd": "open -a Terminal.app "$(dirname \"$file\")"; osascript -e 'tell application \"Terminal\" to do script "cd \"$(dirname \"$file\")\" && python3 -u \"$file\""'"
}
]
}
- Windows 用户替换为：
"shell_cmd": "cmd /c python -u "$file""；若需交互，用variants启动命令提示符（注意路径空格需转义） - 保存为
Python3.sublime-build，之后在Tools → Build System中选择它 - ⚠️ 注意：
-u参数强制未缓冲输出，否则print()可能延迟显示或卡住
安装 Package Control 后必装的 Python 辅助插件
Package Control 是 Sublime 插件生态入口，但不是所有 Python 插件都值得装。重点解决三个实际痛点：代码补全不准、缩进混乱、调试缺失。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 装
Anaconda插件（非 Anaconda Python 发行版）：提供跳转定义、PEP8 检查、自动补全，但需关掉它的内置 lint 引擎，改用pylint或flake8（避免与你本地环境冲突） - 装
EditorConfig：统一团队缩进风格，尤其当项目含.editorconfig文件时，它比 Sublime 原生设置更可靠 - 不推荐装
SublimeCodeIntel：维护停滞，Python 3.8+ 类型提示支持差，常卡死或报ImportError - 如需调试，别指望 Sublime 原生支持断点——老老实实用
print()或换 VS Code；硬要集成，可试SublimeDebugger，但它依赖外部debugpy，配置链路长、易权限失败
常见错误：中文路径/文件名导致构建失败
Sublime 在 Windows 下调用 python.exe 时，若文件路径含中文，shell_cmd 中的 $file 变量传入后可能被错误编码，引发 UnicodeDecodeError 或 SyntaxError: Non-UTF-8 code starting with。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 开发路径彻底避开中文：把项目放在
C:dev或~/code/这类纯 ASCII 路径下 - 如果无法迁移，临时方案是构建前手动复制文件绝对路径，在终端中执行
python3 xxx.py——这不是 Sublime 的问题，是 Windows 控制台默认编码（GBK）与 Python 3 默认 UTF-8 解码不匹配所致 - Mac/Linux 用户较少遇此问题，但若终端 locale 非
en_US.UTF-8，同样可能触发，可用export LANG=en_US.UTF-8临时修复
真正麻烦的从来不是配构建系统，而是 Python 解释器本身是否干净、PATH 是否被多版本污染、以及你有没有意识到 Sublime 从不管理虚拟环境——每次都要手动激活 venv 后再启动 Sublime，否则 import 必然失败。
