Sublime Text 运行 PHP 需先确保系统已安装 PHP 并配置好 PATH；默认支持 PHP 语法高亮，只需保存为 .php 文件或手动设置语言；运行脚本必须配置 Build System，指定 php 解释器路径；未保存文件时 $file 为空导致构建失败。
Sublime Text 本身不内置 PHP 运行能力，所谓“安装 PHP 插件”实际是两类需求：一是语法高亮与代码补全（靠 PHP 语言包），二是真正执行 PHP 脚本（需系统已安装 PHP，并配置 Build System）。没装好 PHP CLI 或路径不对，插件装得再多也跑不起来。
确认系统已安装 PHP 并可命令行调用
这是所有后续操作的前提。Sublime 不负责提供 PHP 解释器，只负责调用它。
- 在终端（macOS/Linux）或命令提示符（Windows）中运行
php -v，必须返回版本号，否则先去官网下载安装 PHP 并加入系统PATH - Windows 用户特别注意：
php.exe路径不能含中文、空格或特殊符号；推荐放在例如C:\php\这类干净路径下，并把该路径加进系统环境变量PATH - macOS 使用 Homebrew 安装的用户，
which php通常返回/opt/homebrew/bin/php（Apple Silicon）或/usr/local/bin/php（Intel），记下这个完整路径
启用 Sublime 内置的 PHP 语法支持
Sublime Text 4 默认已包含 PHP 语言定义，无需额外安装插件。只需确保当前文件被正确识别为 PHP：
- 新建文件 → 保存为
test.php（扩展名必须是.php） - 或点击右下角语言标识（如 “Plain Text”）→ 选择
PHP→ 文件即获得语法高亮、括号匹配、基础函数提示 - 如果没看到
PHP选项，说明语言包损坏，可通过Package Control → Install Package → PHP重装（但极少需要）
配置 PHP Build System（让 Ctrl+B / Cmd+B 运行脚本）
这才是“运行 PHP”的核心步骤。Sublime 通过 Build System 调用系统 PHP 解释器执行当前文件。
立即学习“PHP免费学习笔记（深入）”；
- 菜单栏选择
Tools → Build System → New Build System… - 替换全部内容为以下 JSON（根据你的系统路径调整
cmd中的php路径）：
{
"cmd": ["php", "$file"],
"file_regex": "php$",
"selector": "source.php",
"encoding": "utf-8"
}
保存为 PHP.sublime-build（自动存入 Packages/User/ 目录）
- 再次打开
Tools → Build System，应能看到新出现的PHP选项，选中它 - 写一段测试代码，如
，按Ctrl+B（Windows/Linux）或Cmd+B（macOS），输出面板将显示结果 - 若报错
'php' is not recognized as an internal or external command，说明php不在PATH中，此时必须改用绝对路径，例如 Windows："cmd": ["C:\\php\\php.exe", "$file"]；macOS："cmd": ["/opt/homebrew/bin/php", "$file"]
可选：安装 PHPCompanion 或 SublimeLinter-php（非必需，但提升体验）
这些是增强型插件，解决的是开发效率问题，不是运行前提：
-
PHPCompanion：提供快速生成class、function模板，需先装Package Control -
SublimeLinter-php：实时语法检查（依赖系统php -l命令），若php -l test.php在终端能工作，它就能用 - 注意：它们不解决“无法运行 PHP”的问题，只是锦上添花；装了也不代表 Ctrl+B 就能用了——Build System 仍需单独配置
最容易被忽略的一点：Sublime 的 Build System 是基于当前视图的，如果你在未保存的临时标签页里写 PHP 代码，$file 变量为空，Ctrl+B 会失败。务必先保存为 .php 文件再运行。
