Sublime Text 本身不带 PHP 解释器，所有运行、语法检查等功能均依赖系统已安装且 PATH 可访问的 php CLI；必须先在终端执行 php -v 验证成功，再配置 Build System 调用 php -f $file 实现 Ctrl-B 运行。
Sublime Text 本身不带 PHP 解释器，所有“运行”“语法检查”“格式化”功能都依赖系统已安装的 php CLI 可执行文件。没配好 php 命令，后续一切配置都会静默失败或报 command not found。
确认 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。常见修复方式：
立即学习“PHP免费学习笔记（深入）”；
- macOS Homebrew 用户：检查
which php，通常是/opt/homebrew/bin/php或/usr/local/bin/php；若无输出，运行brew install php - Windows XAMPP 用户：路径类似
C: mppphpphp.exe，需把C: mppphp加入系统环境变量PATH（注意不带.exe） - Linux（apt）：运行
sudo apt install php-cli，默认路径为/usr/bin/php
别信“装完就自动可用”——GUI 启动的 Sublime 往往不继承 shell 的完整 PATH，尤其在 macOS M1/M2 或 Windows WSL 下。
用 Build System 实现 Ctrl+B 运行 PHP 脚本
这是最轻量、最可控的运行方式，不依赖插件，适合调试单文件逻辑。操作路径：Tools → Build System → New Build System…，填入以下内容（按你系统调整）：
{
"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（Windows/Linux）或 Cmd+B（macOS）即可在底部面板看到输出。
容易踩的坑：
-
cmd里写成["php.exe", ...]—— Windows 下只要php已在PATH，就不该加.exe；加了反而可能去搜php.exe.exe - 漏掉
"selector": "source.php"—— 导致快捷键对非 PHP 文件也响应，或完全不触发 - 路径含空格（如
C:Program Filesphpphp.exe）没用引号包裹 —— Windows 下会解析失败，应写成["C:\Program Files\php\php.exe", ...] - 想做语法检查？把
-f换成-l；想捕获错误行号？file_regex要匹配实际报错格式
让 .phtml、.module 等后缀也高亮为 PHP
Sublime 默认只识别 .php，其他扩展名（如 Drupal 的 .module、旧项目里的 .phtml）打开就是 Plain Text，连 <?php 都不着色。解决方法不是装插件，而是手动关联语法：
打开一个 .phtml 文件 → 右下角点击当前语法名（比如 “Plain Text”）→ 选择 PHP；更彻底的做法是设置自动映射：
菜单栏 → Preferences → Settings – Syntax Specific → 在右侧 JSON 中添加：
{"extensions": ["phtml", "module", "inc"]}
注意：必须是 Settings – Syntax Specific，不是 Settings – User；否则无效。保存后，这些后缀下次打开就自动用 PHP 语法高亮。
为什么 SublimeLinter-php 不报错也不提示
因为插件底层还是调用 php -l，它和 Build System 共享同一个约束：找不到 php 就彻底静默。即使插件装好了，也会因 GUI 环境下 PATH 不全而失效。
实操建议：
- 先确保终端里
php -l /path/to/file.php能正常返回语法错误 - 再在
SublimeLinter设置中显式指定php_executable路径，例如："php_executable": "/opt/homebrew/bin/php"
- 不要依赖“自动发现”，尤其在 macOS GUI 或 Windows 快捷方式启动 Sublime 时
- 格式化推荐用
phpcbf+PHP_CodeSniffer插件，但同样要配对phpcbf_executable绝对路径
真正容易被忽略的是：Sublime 的构建系统和插件都运行在 GUI 进程里，它不会读取你 shell 配置文件（如 ~/.zshrc）里写的 export PATH=...，除非你从终端用 subl . 启动它。
