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 环境变量干扰。
- 菜单 →
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 必须匹配语法类型——这两点一旦出错,现象都是“看起来装好了,但什么也不发生”。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











