Sublime Text 的 PHP 功能依赖系统 php CLI，必须正确配置路径并设置语法识别；需安装 PHP Companion 和 SublimeLinter-php 插件并手动指定 php_executable 路径，同时配置 Build System 和文件后缀关联，否则功能静默失效。
Sublime Text 本身不带 PHP 运行能力，所有 PHP 相关功能都依赖系统已安装的 php CLI 可执行文件——没配好这个，装再多插件也白搭。
确认 php CLI 已就位且路径正确
这是全部 PHP 插件生效的硬性前提，跳过这步，后续所有配置都会静默失效。
- 打开终端（macOS/Linux）或命令提示符/PowerShell（Windows），执行
php -v；成功返回类似PHP 8.2.12才算过关 - 若报
'php' is not recognized或command not found，说明未安装或未加入PATH - 常见真实路径要记牢：
/opt/homebrew/bin/php（macOS M1/M2 Homebrew）、C:\xampp\php\php.exe（Windows XAMPP）、/usr/bin/php（Ubuntu apt 安装） - GUI 启动的 Sublime（尤其是 macOS 和 WSL）经常不继承 shell 的
PATH，别只信“终端能跑，Sublime 就能跑”
安装 PHP Companion 和 SublimeLinter-php
这两个插件分别解决代码跳转补全和语法/规范检查，但都必须手动指定 php 路径，否则功能残缺。
- 用
Ctrl+Shift+P→Package Control: Install Package搜索并安装：PHP Companion、SublimeLinter-php - 装完后，进
Preferences → Package Settings → PHP Companion → Settings - User，填入你执行which php输出的绝对路径，例如："php_executable": "/opt/homebrew/bin/php" - 同理，
Preferences → Package Settings → SublimeLinter → Settings中也要加："php_executable": "/opt/homebrew/bin/php" - 漏掉任一配置，
Go to Definition会跳空，php -l语法检查也不会触发
配置 Build System 直接运行 .php 文件
这是最轻量、最可控的单文件调试方式，不依赖插件，也不受 GUI 环境变量干扰。
立即学习“PHP免费学习笔记（深入）”；
- 菜单 →
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缺失导致快捷键不生效；路径含空格却没用引号包裹
让语法高亮和文件关联真正覆盖常用后缀
默认只认 .php，但实际项目中常遇到 .phtml、.module、.inc 等，不显式绑定就无法触发补全、跳转、Build 等行为。
- 右下角点击当前语法名（如
Plain Text）→Open all with current extension as → PHP，可临时解决 - 永久绑定：菜单 →
Preferences → Settings – Syntax Specific→ 在右侧加：
{"extensions": ["phtml", "module", "inc"]}
- PHP Companion 的跳转、SublimeLinter-php 的检查、Build System 的触发，全都依赖这个语法识别结果
- 如果某文件右下角始终显示
Plain Text或HTML，那上面所有插件功能都等于没开
最易被忽略的是：GUI 启动的 Sublime 不继承 shell PATH，以及 Build System 的 selector 必须匹配语法类型——这两点一旦出错，现象都是“看起来装好了，但什么也不发生”。
