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