Sublime Text 无法识别 PHP 代码的根本原因是语法模式未正确设置，需手动指定 PHP 语法高亮；php: command not found 错误源于系统未配置 PHP CLI 环境变量；构建系统需正确配置 cmd、selector 等字段并手动重选才能生效。
Sublime Text 本身不识别 PHP 代码，除非你手动告诉它这是 PHP —— 高亮失效、语法检查报错、Ctrl+B 没反应，90% 都卡在这一步。
为什么打开 .php 文件还是 Plain Text？
Sublime 默认只对 .php 后缀做自动语法映射，但遇到以下情况就会退化成纯文本：
- 文件没后缀（比如新建一个
index写 PHP 代码） - 用了非标准扩展名（
.phtml、.module、.inc、.install） - 文件开头没写
<?php或被 BOM/编码干扰识别
右下角显示 “Plain Text” 就是铁证。别点插件、别改构建系统——先切语法模式。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 打开文件后，按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Set Syntax: PHP回车 - 更彻底：菜单 →
Preferences → Settings – Syntax Specific，在右侧加这段（注意是 JSON 格式）：{"extensions": ["phtml", "module", "inc", "install"]} - 别误粘贴到
Settings – User里，语法映射只在 Syntax Specific 下生效
php: command not found 是 Sublime 的错吗？
不是。这是系统根本找不到 php 命令，Sublime 的构建系统只是暴露了这个问题。
验证方式很简单：关掉 Sublime，打开终端（macOS/Linux）或命令提示符（Windows），执行：php -v
如果报错，说明 PATH 没配好，或者压根没装 CLI 版本。常见修复路径：
- macOS Homebrew 用户：
which php，通常是/opt/homebrew/bin/php或/usr/local/bin/php；没输出就先brew install php - Windows XAMPP 用户：路径类似
C: mppphpphp.exe，必须把C: mppphp（不含.exe）加进系统环境变量Path - Linux（apt）：
sudo apt install php-cli，默认路径是/usr/bin/php
⚠️ 注意：GUI 启动的 Sublime（比如从 Dock 或开始菜单点开）往往不继承 shell 的完整 PATH，尤其在 macOS M1/M2 或 Windows WSL 下。临时解法是终端里运行 subl 启动编辑器。
Build System 怎么写才不会静默失败？
构建系统本质就是让 Sublime 调用系统里的 php 命令。写错一个字段，Ctrl+B 就没反应，也不报错。
关键字段说明与避坑点：
-
"cmd"：必须写对命令和参数。想运行脚本用["php", "-f", "$file"]；想只做语法检查换-l；Windows 绝对路径含空格要加引号，如["C:\Program Files\php\php.exe", "-f", "$file"] -
"selector"：必须是"source.php"，否则快捷键不绑定到 PHP 文件 -
"file_regex"：用于捕获错误行号，推荐用"^.*?on line ([0-9]+)"，这样点击错误信息能跳转 -
"working_dir"：设为"$file_path"，确保require、include相对路径正常
示例（通用写法，PATH 已通）：
{
"cmd": ["php", "-f", "$file"],
"selector": "source.php",
"file_regex": "^.*?on line ([0-9]+)",
"working_dir": "$file_path"
}
语法检查能定位到具体行，但为啥不报错？
因为默认构建系统没启用语法检查模式。你当前用的是 -f（执行），不是 -l（lint）。两者行为完全不同：
-
php -f index.php：运行脚本，有语法错误才报错，且只报第一个 -
php -l index.php：仅检查语法，报所有错误，并返回非零退出码，适合集成进构建流程
想快速查错，新建一个 Build System，"cmd" 改成：["php", "-l", "$file"]，保存为 PHP Lint.sublime-build，切换使用即可。
真正容易被忽略的点：Sublime 不会自动重载构建系统配置。改完 .sublime-build 文件后，得手动在 Tools → Build System 里重新选一次，否则 Ctrl+B 还是跑旧配置。
