sublime text 无法直接运行 php，必须依赖系统已安装的 php 解释器并正确配置 path；构建系统需调用 php -f $file，且推荐从终端启动以确保环境变量生效。
Sublime 本身不运行 PHP，得靠系统命令行
Sublime Text 是个编辑器，不是 IDE，它没有内置 PHP 解释器。所谓“运行 PHP”，本质是调用你本地已安装的 php 命令执行脚本。如果终端里输 php -v 报错或没反应，Sublime 就不可能跑起来——别折腾构建系统，先搞定环境变量和 PHP 安装。
常见错误现象：Unable to find command php、command not found: php、构建后空白或闪退。
- 确认 PHP 已安装：在终端运行
which php（macOS/Linux）或where php（Windows CMD），有输出路径才算到位 - 如果没输出，重装 PHP 并勾选「Add PHP to PATH」（Windows 安装包）或手动把
/usr/local/bin（macOS Homebrew）或C:php（Windows）加进系统 PATH - Sublime 构建系统读取的是**启动 Sublime 时的环境变量**；如果从桌面图标启动，PATH 可能不包含你终端里配好的路径 —— 推荐从终端启动：
subl .
用 Build System 调用 php -f 执行当前文件
这是最轻量、最可控的方式，适合调试单个脚本。别用 php -S（内置服务器）当构建任务，它会卡住 Sublime，且无法自动退出。
操作路径：Tools → Build System → New Build System…，粘贴以下内容并保存为 PHP.sublime-build：
立即学习“PHP免费学习笔记（深入）”；
{
"cmd": ["php", "-f", "$file"],
"selector": "source.php",
"file_regex": "php.*?on line ([0-9]+)",
"working_dir": "$file_path"
}
说明与注意点：
-
"cmd"中-f明确指定执行文件，比裸写php $file更稳妥，避免被当成 CLI 参数解析 -
"file_regex"让报错行号可点击跳转，但仅匹配标准 PHP 错误格式；若用 Xdebug 或自定义错误处理器，这行可能失效 - Windows 用户需确认路径分隔符：Sublime 自动处理
$file，不用写成$file_path\$file_name - 不建议加
-l（语法检查）作为默认构建，它不输出错误详情，且成功时无反馈，容易误判
PHP 文件保存后自动运行？别信插件宣传
像 SublimeOnSaveBuild 这类插件确实能触发构建，但对 PHP 来说风险高、收益低。
问题根源在于 PHP 脚本常含 exit()、die()、重定向或输出 HTTP 头，自动运行会导致终端刷屏、阻塞、甚至意外修改数据库（比如保存时顺手跑了 db_migrate.php）。
- 真需要保存即运行？只对纯计算类脚本（如
calc.php）开，且务必在构建命令末尾加> /dev/null 2>&1（macOS/Linux）或> NUL 2>&1（Windows）压制无关输出 - 更安全的做法：用快捷键
Ctrl+B（Windows/Linux）或Cmd+B（macOS）手动触发，眼见为实 - 所有“自动刷新浏览器”类功能，本质是监听文件变化 + 调用
curl或 WebSocket，和 PHP 构建无关，别混为一谈
想调试（断点/变量查看）？Sublime 不行，换工具
Sublime 没有原生调试协议支持，Xdebug 配合 Sublime 的插件（如 Xdebug Client）早已停止维护，最新 PHP 版本（8.0+）基本连不上。
这不是配置问题，是架构限制：Sublime 缺少调试器所需的进程控制、栈帧管理、变量求值等底层能力。
- 临时查
var_dump()？用error_log()写到日志，比echo更不影响 HTTP 流程 - 需要真断点？VS Code +
php-debug扩展是目前最稳选择，配置一次就能用 Xdebug 3 - 如果坚持用 Sublime，唯一可行路径是：用 CLI 启动带
-dxdebug.mode=debug的 PHP，再用外部终端观察输出 —— 但这等于放弃“调试”，只剩“看日志”
真正卡住人的，从来不是怎么让 Sublime “跑起来”，而是搞不清它能做什么、不能做什么。PHP 开发绕不开 CLI 环境、Web 服务器、调试器三层协作，编辑器只是其中一环。配好了构建系统，不代表开发环境就齐了。
