Sublime Text 运行 PHP 的前提是系统已安装并正确配置 php CLI，终端执行 php -v 成功是唯一前置条件；随后需配置 Build System（如 PHP.sublime-build）调用 php 解释器，再安装 PHP Companion、SublimeLinter-php 和 LSP-intelephense 插件以实现补全、语法检查与调试。
Sublime Text 本身不运行 PHP，所有 PHP 功能都依赖系统已安装的 php CLI 可执行文件。没配好这个，装再多插件也白搭——这是 90% 配置失败的根源。
确认终端能跑 php -v 是唯一前置条件
别跳过这步，GUI 启动的 Sublime（尤其是 macOS 和 WSL）经常不继承 shell 的 PATH，终端能跑 ≠ Sublime 能跑。
- 打开终端（macOS/Linux）或命令提示符/PowerShell（Windows），执行
php -v - 成功返回类似
PHP 8.2.12才算过关；若报'php' is not recognized或command not found，说明 CLI 没装或没进PATH - 常见路径要记牢：
/opt/homebrew/bin/php（macOS M1/M2 Homebrew）、C:\xampp\php\php.exe（Windows XAMPP）、/usr/bin/php（Ubuntu apt 安装）
用 Build System 直接运行 .php 文件最可靠
不依赖插件，适合单文件调试，也是后续插件功能（如 linting、补全）正常工作的基础。
- 菜单 → Tools → Build System → New Build System…
- 粘贴以下内容（注意把
cmd中的路径换成你本地真实的php路径）：{ "cmd": ["php", "-f", "$file"], "selector": "source.php", "file_regex": "^.*?on line ([0-9]+)", "working_dir": "$file_path" } - 保存为
PHP.sublime-build（自动存到Packages/User/） - 打开任意
.php文件，按Ctrl+B（Win/Linux）或Cmd+B（macOS），输出会出现在底部面板 - 常见坑：
cmd写成["php.exe"]（Windows 下若已加 PATH，不该带.exe）；selector缺失导致快捷键不生效；路径含空格却没用引号包裹
只装这 3 个插件，覆盖核心需求
贪多易冲突、更新断、配置乱。以下组合实测稳定、更新勤：
立即学习“PHP免费学习笔记（深入）”；
-
PHP Companion：提供__construct快速生成、use自动补全、die(var_dump())一键包裹等，不依赖外部 CLI 工具 -
SublimeLinter-php：需本地有php命令，它调用php -l做语法检查；若报错Could not locate php，得在插件设置里填绝对路径（如 Windows 是C:\xampp\php\php.exe） -
LSP-intelephense（非必需但强烈推荐）：现代补全/跳转/重构能力的核心；首次启动会下载二进制，若卡在Starting intelephense，去设置里把"download": true改成false，手动下载并填入"binary_path"
语法高亮和后缀绑定常被忽略
默认只认 .php，其他后缀（如 .phtml、.module）需手动关联；补全跳转失效，大概率是插件没指向正确的 php 二进制。
- 右下角点击当前语法名（如
Plain Text）→Open all with current extension as→PHP，可临时解决 - 永久绑定：菜单 → Preferences → Settings – Syntax Specific → 在右侧加：
{"extensions": ["phtml","module","inc"]} -
PHP Companion和SublimeLinter-php都要单独设php_executable：前者在Preferences → Package Settings → PHP Companion → Settings - User；后者在Preferences → Package Settings → SublimeLinter → Settings，填入which php输出的绝对路径
最容易被忽略的是：Build System 和插件里的 php_executable 路径必须一致，且不能依赖 shell 别名或未生效的环境变量；GUI 启动方式下，硬编码绝对路径比依赖 PATH 更稳。
