sublime text一键运行php/python脚本的前提是安装时勾选add to path和上下文菜单集成，否则subl命令失效、右键缺失、双击无法打开；路径须避开空格和中文，且build system需硬编码php/python3绝对路径。
subl 命令能用，插件能装，PHP/Python 脚本一键运行——这三件事全靠安装阶段就做对，跳过任何一步，后面全得返工。
安装时必须勾选的两个选项（Windows/macOS/Linux 都适用）
不是“可选”，是硬性前提。不勾，subl 命令失效、右键菜单消失、双击文件打不开，后续所有配置都悬在半空。
- Add to explorer context menu（Windows）或等效的 Finder / Nautilus 集成（macOS/Linux）：否则右键找不到“Open with Sublime Text”
- Associate with .txt files：否则双击任意文本文件不会默认用 ST 打开，连基础编辑都卡住
- 安装路径避开空格和中文（如
C:\Program Files\或D:\我的工具\），推荐D:\tools\sublime_text或/opt/sublime_text
验证安装是否真正生效（别信“图标出来了就算装好”）
终端里跑不通 php -v 或 python --version，Sublime 就不可能跑脚本；GUI 启动的 ST 不继承 shell 的 PATH，这是 macOS 和 WSL 最常翻车的点。
- 打开终端（不是 PowerShell GUI，不是 iTerm 图形窗口，而是纯命令行环境），执行：
php -v和python3 --version，必须返回版本号 - 再执行：
which php和which python3，记下输出的绝对路径（比如/opt/homebrew/bin/php或/usr/bin/python3） - 然后在 Sublime 里按
Ctrl+`调出控制台，输入：import os; os.environ.get('PATH')，对比它输出的 PATH 是否包含上面两个路径 - 如果不含，说明 GUI 环境没继承 shell PATH——Build System 必须硬编码路径，插件配置也得填绝对路径
Build System 怎么写才不报错（PHP/Python 通用模板）
别依赖插件自动运行，先用原生 Build System 把单文件执行链跑通。它轻、快、可控，且错误信息直接暴露问题根源。
- 菜单 → Tools → Build System → New Build System…
- 粘贴以下内容（把
php换成你which php输出的完整路径，python3同理）：
{
"cmd": ["php", "-f", "$file"],
"selector": "source.php",
"file_regex": "^.*?on line ([0-9]+)",
"working_dir": "$file_path"
}
- 保存为
PHP.sublime-build（自动存到Packages/User/） - 同理建一个
Python.sublime-build，cmd改成["python3", "-u", "$file"] - 常见坑：
cmd里写"php.exe"（Windows 下 PATH 已设好就不用加后缀）；selector缺失导致Ctrl+B没反应；路径含空格却没用引号包裹（应写["/Applications/Sublime Text.app/Contents/MacOS/Sublime Text"]）
Package Control 装不上？先看网络和权限
不是代码错了，就是网络不通或目录不可写。ST4 的安装脚本和 ST3 不兼容，复用旧代码必失败。
- 打开控制台（
Ctrl+`），粘贴官网最新脚本（域名是packagecontrol.io，不是旧的sublime.wbond.net） - 如果报
URLError，先在终端执行：curl -I https://packagecontrol.io，返回200才算通 - 国内用户若超时，手动下载
Package Control.sublime-package文件，放进Installed Packages/目录（路径可通过sublime.installed_packages_path()查） - Mac 用户若提示
Permission denied，说明Installed Packages/不可写，改放~/Library/Application Support/Sublime Text/Installed Packages/
Ctrl+B 就只显示空白面板，连报错都没有。
