sublime text 运行 php 本质是调用本地 php 命令行程序，需先确保终端中 php -v 可正常输出版本号；再配置 build system，windows 用户须指定 php.exe 绝对路径，macos/linux 可依赖 path；常见错误包括路径错误、编码非 utf-8 无 bom、未重启 sublime 生效等。
Sublime Text 本身不运行 PHP，它只是个编辑器；所谓“运行 PHP”，本质是调用你本地已安装的 php 命令行可执行文件来执行当前文件。 配置失败，90% 是因为没找到或没配对这个命令，而不是 Sublime 缺什么插件。
确认本地 php 命令是否可用
这是所有配置的前提。Sublime 不会帮你装 PHP，也不会自动识别路径。
- 打开终端（macOS/Linux）或命令提示符/PowerShell（Windows），输入
php -v—— 必须能立刻输出版本号，比如PHP 8.2.12 - 如果报错
'php' is not recognized as an internal or external command（Windows）或command not found: php（macOS/Linux），说明 PHP 没加到系统PATH，得先解决这个 - Windows 用户尤其注意：XAMPP/WAMP/MAMP 的
php.exe默认不在 PATH 里，不能只靠双击安装包就认为“已安装”
在 Sublime 中配置 php 路径（Build System）
Sublime 用 Build System 来定义“按下 Ctrl+B（macOS 是 Cmd+B）时执行什么命令”。PHP 的 Build System 就是调用 php 解释器。
- 菜单栏 →
Tools→Build System→New Build System… - 删掉默认内容，粘贴以下内容（根据你的系统选一个）：
// macOS / Linux（假设 php 在 PATH 中）
{
"cmd": ["php", "$file"],
"file_regex": "php$",
"selector": "source.php"
}
// Windows（路径必须是正斜杠或双反斜杠，且含 .exe）
{
"cmd": ["C:/xampp/php/php.exe", "$file"],
"file_regex": "php$",
"selector": "source.php"
}
- 保存为
PHP.sublime-build（自动存到Packages/User/目录） - 之后在
Tools → Build System里选中它，再按Ctrl+B就能运行当前 PHP 文件 - 别用网上流传的带
shell_cmd或cmd混用的写法——Sublime 3/4 对 Windows 路径解析很敏感，cmd数组最稳
常见错误现象和对应检查点
运行失败时，Sublime 底部状态栏会显示错误，但信息极简。得结合现象反推问题。
立即学习“PHP免费学习笔记（深入）”；
- 显示
[WinError 2] The system cannot find the file specified：Build System 里写的php.exe路径不存在，或拼错了（比如写成php.ex） - 显示空白或一闪而过：PHP 脚本有
exit()、die()，或输出了 HTML 但没开浏览器——Sublime 的 Build 结果只显示 stdout，不会自动打开网页 - 报
Parse error: syntax error但代码明明没错：可能是当前文件编码不是 UTF-8 无 BOM，或用了中文全角标点（比如引号、分号） - 修改了 Build 文件却没生效：重启 Sublime，或手动在
Build System菜单里重新选一次，Sublime 不会热重载 Build System
真正卡住人的，往往不是配置步骤多，而是把“PHP 环境”和“Sublime 配置”当成一件事——前者得自己搞定，后者只是指路。路径写错、PATH 没通、编码藏了不可见字符，这三个地方反复核对，基本就能跑起来。
