必须先确保系统已安装PHP且终端执行php -v成功，否则Sublime所有PHP功能均会静默失败；Sublime本身不带PHP解释器，所有构建、检查、格式化均依赖系统php CLI可执行文件。
php -v 都不通过，别配 Sublime
Sublime Text 本身不带 PHP 解释器，所有构建、语法检查、格式化功能都依赖你系统里已安装的 php CLI 可执行文件。如果终端里执行 php -v 报错，后续一切配置都会静默失败或报 command not found。
验证方式：打开终端（macOS/Linux）或 CMD/PowerShell（Windows），输入：
php -v
必须看到类似 PHP 8.2.12 的输出。否则：
- macOS Homebrew 用户：运行
which php，常见路径是/opt/homebrew/bin/php（M1/M2）或/usr/local/bin/php（Intel）；若无输出，先brew install php - Windows XAMPP 用户：路径通常是
C:/xampp/php/php.exe，需把C:/xampp/php加进系统 PATH（注意不带.exe） - Linux（apt）用户：确认装的是
php-cli包，运行sudo apt install php-cli，默认路径为/usr/bin/php
特别注意：从 Dock 或桌面快捷方式启动 Sublime，它往往不继承 shell 的完整 PATH；推荐在终端中执行 subl . 启动编辑器，确保环境变量生效。
立即学习“PHP免费学习笔记（深入）”；
Build System 怎么写才不白配
Sublime 的构建系统本质就是调用你系统的 php 命令，不是“启动服务器”，只是执行脚本。最简可靠配置如下：
{
"cmd": ["php", "-f", "$file"],
"selector": "source.php",
"working_dir": "$file_path"
}
关键点：
-
-f参数不能省——避免某些 PHP 版本把$file当作参数传入，导致卡住或解析错误 -
"selector": "source.php"必须保留——否则按Ctrl+B时对非 PHP 文件也响应，或完全不触发 - Windows 下若
php不在 PATH，必须写绝对路径，如：["C:/xampp/php/php.exe", "-f", "$file"]；路径含空格（如C:Program Filesphpphp.exe）必须用双引号包裹，且反斜杠要双写："C:\Program Files\php\php.exe" - 文件未保存时会报
Could not open input file——$file变量为空，务必先Ctrl+S
.phtml、.inc 等后缀怎么高亮和构建
Sublime 默认只识别 .php 后缀，其他如 .phtml、.inc、.module 打开就是 “Plain Text”，连 <?php 都不着色。
临时解决：打开对应文件 → 右下角点击当前语法名（如 “Plain Text”）→ 选择 “PHP”。
永久绑定：菜单栏 → Preferences → Settings – Syntax Specific → 在右侧 JSON 中添加：
{"extensions": ["phtml", "inc", "module"]}
注意：不是 Settings – User，那是全局配置，语法关联必须走 Settings – Syntax Specific 才生效。
但构建系统仍不会自动触发——因为 "selector": "source.php" 只匹配 PHP 语法，不匹配文件扩展名。想让 .phtml 也能用 Ctrl+B，得改构建系统：
"selector": "source.php, source.phtml"
或更稳妥地，把构建系统里的 "selector" 改成：
"selector": "embedding.php, source.php, source.phtml"
中文乱码、Parse error、浏览器 404 是什么问题
这些都不是构建系统配置错了，而是混淆了 CLI 执行和 Web 请求场景：
- Windows 控制台默认 GBK 编码，而 Sublime 输出 UTF-8：在构建系统 JSON 中加一行
"encoding": "cp936" - 文件含中文路径或内容却报
Parse error：XAMPP 自带的 PHP 默认用 cp1252 解析，加"encoding": "cp936"；或换 Homebrew 安装的 PHP（UTF-8 友好） - 按
Ctrl+B能出结果，但浏览器访问.php文件显示源码或 404：这是典型混淆——Sublime 没有内置 Web Server，Ctrl+B是 CLI 执行，$_GET/$_POST全为空；要测试 Web 行为，得配 Apache/Nginx 或用php -S启动本地服务
真正容易被忽略的是：CLI 和 Web 使用的 php.ini 往往不同。比如你在 CLI 里 php -v 显示已启用 opcache，但浏览器里 phpinfo() 却没开——那是因为 Web 用的是另一份配置。调试前，务必确认两者一致。
