Sublime Text运行Python需先确认系统PATH中存在python3命令，再创建名为Python.sublime-build的构建系统并置于Packages/User/目录，内容为{"shell_cmd":"python3 -u \"$file\"","file_regex":"^\sFile \"(.)\", line ([0-9]*)","selector":"source.python"}。
确认 Python 是否在系统 PATH 中
便携版 Sublime 本身不带 Python，它完全依赖你系统里已安装的 python 或 python3 命令。如果终端里执行 python --version 报错，Sublime 的 Ctrl+B 一定失败——不是配置问题，是根本没路可走。
- Windows 用户：安装 Python 时务必勾选 Add Python to PATH；若已装但漏选，重装或手动把类似
C:\Users\XXX\AppData\Local\Programs\Python\Python311\的路径加进系统环境变量 - macOS/Linux 用户：检查
which python3输出，若为空，需用 pyenv、Homebrew 或系统包管理器重新安装并确保 bin 目录在$PATH里 - 别信“我双击 python.exe 能运行”——Sublime 调用的是 shell 命令，不是图形界面程序
创建正确的 Python.sublime-build 文件
便携版 Sublime 和普通版一样，build system 必须放在 Packages/User/ 目录下，且文件名必须以 .sublime-build 结尾。用 Tools → Build System → New Build System… 创建后，**必须手动保存为 Python.sublime-build（不是 .json，也不是 Python3.sublime-build）**，否则菜单里不会出现“Python”选项。
- 内容推荐用
shell_cmd形式（兼容性更好）：{ "shell_cmd": "python3 -u \"$file\"", "file_regex": "^[ ]*File \"(*?)\", line ([0-9]*)", "selector": "source.python" } - 如果系统只认
python，就把python3换成python；别混用cmd和shell_cmd字段 - 避免路径含中文或空格：如果
$file对应的 .py 文件路径里有空格，shell_cmd用双引号包裹更稳妥；cmd数组形式反而容易因空格截断
运行时 input() 不工作怎么办
Sublime 底部的 build panel 是只读输出流，不提供 stdin 输入能力。只要脚本里有 input() 或 raw_input()，运行后会卡住，光标不动，也没报错——这是正常表现，不是崩溃。
- 临时方案：把
input()替换成固定值，比如name = "Alice"，验证逻辑是否正确 - 真要交互调试：改用终端执行，或装
SublimeREPL插件（需通过 Package Control 安装），然后用Tools → SublimeREPL → Python → Python Run Current File - 注意：SublimeREPL 在便携版里也能用，但插件数据默认存在
Packages/下，不跨设备同步；如需迁移，记得一起复制Packages/目录
便携场景下的路径与编码隐患
便携版常被放在 U 盘或网盘同步目录，这类路径容易触发两个隐藏问题：一是文件系统大小写敏感性不一致（尤其 macOS ↔ Windows），二是 UTF-8 BOM 或编码声明缺失导致中文乱码。
立即学习“Python免费学习笔记（深入）”；
- 确保 .py 文件保存为
UTF-8 without BOM（Sublime 右下角状态栏点编码名可切换） - 在文件开头显式加编码声明：
# -*- coding: utf-8 -*-，比依赖编辑器猜测更可靠 - 如果便携盘是 FAT32 格式，避免在路径中使用 Unicode 字符（如中文文件夹名），某些旧版 Windows 会识别异常
- 不要把 Python 安装目录和 Sublime 一起塞进同一个 U 盘再指望
cmd里写绝对路径——不同电脑盘符可能变化，shell_cmd仍应坚持用python3命令名而非C:\Python311\python.exe
便携版最大的陷阱不是“怎么配”，而是误以为它能脱离系统环境独立运行。所有构建行为最终都回落到操作系统的 shell，PATH、编码、文件系统特性这些底层约束，一个都绕不开。
