Sublime中PHP语法检查失效的主因是php命令不可用，需确认系统PATH中存在php可执行文件并显式指定其绝对路径；SublimeLinter-php依赖php -l校验，须配置正确的executable和lint_mode为"save"；调试需借助Terminus或自建Build System运行php -f。
Sublime 中 PHP 语法检查不生效？先确认 php 命令是否可用
很多配置失败的根本原因，是 Sublime 找不到系统级的 php 可执行文件。它不读取你的 IDE 或终端里配置好的 PATH，而是依赖系统环境或显式指定路径。
验证方法：在终端中运行 which php（macOS/Linux）或 where php（Windows CMD），确保输出一个有效路径，比如 /usr/bin/php 或 C:\xampp\php\php.exe。
- 如果命令报错或无输出，说明 PHP 未正确安装或未加入系统 PATH —— 此时任何插件配置都无效
- Mac 用户用 Homebrew 安装的 PHP，常位于
/opt/homebrew/bin/php（Apple Silicon）或/usr/local/bin/php（Intel），需手动指定 - Windows 用户若用 XAMPP/WAMP，别直接填
php，必须写完整路径，如C:\xampp\php\php.exe
用 SublimeLinter-php 做实时语法检查，关键在 executable 和 lint_mode
该插件本质是调用 php -l 检查单个文件，不是跑完整脚本。它默认尝试调用 php，但多数失败源于路径不对或 lint_mode 配置不当。
在 Sublime 的 Preferences → Package Settings → SublimeLinter → Settings 中，修改用户配置：
立即学习“PHP免费学习笔记（深入）”；
{
"linters": {
"php": {
"executable": "/usr/bin/php",
"lint_mode": "save"
}
}
}
-
executable必须填绝对路径，不能留空或写php -
lint_mode推荐设为"save"：避免边写边报错干扰，且能捕获未保存的语法错误（on_type在 PHP 中误报率高） - 如果项目用了不同 PHP 版本（如 PHP 8.2 写的代码被 PHP 7.4 检查），会漏报新语法错误，务必保证
executable指向目标版本
调试 PHP 脚本？别指望 Sublime 原生支持，得靠 Terminus + php -f
Sublime 没有内置 PHP 调试器（不像 VS Code 有 Xdebug 插件）。所谓“调试”，实际是快速运行 + 查看输出，适合 CLI 脚本或简单逻辑验证。
- 装好
Terminus插件后，用快捷键Ctrl+Shift+P→Terminus: Open Default Shell in Panel - 在底部面板中输入：
php -f /path/to/your/script.php，回车即可运行 - 想一键运行当前文件？建一个 Build System（
Tools → Build System → New Build System）：
{
"cmd": ["php", "-f", "$file"],
"selector": "source.php",
"file_regex": "php$"
}
保存为 PHP.sublime-build，之后按 Ctrl+B 就能直接运行当前 PHP 文件。
常见报错：「SublimeLinter: WARNING: php disabled, 'executable' not found」
这是最典型的配置失败提示，不是插件没装好，而是 SublimeLinter-php 根本没找到 PHP 可执行文件。
- 检查点一：确认已安装
SublimeLinter和SublimeLinter-php两个包（后者依赖前者） - 检查点二：在 SublimeLinter 设置里搜
php，看是否有executable字段；若为空或拼写错误（比如写成executabel），立刻修正 - 检查点三：某些杀毒软件或 macOS Gatekeeper 会拦截非签名二进制，导致 Sublime 无法调用
php—— 可临时将 PHP 目录加到白名单，或换用php -v测试是否真能调用
路径、权限、版本对齐——这三件事没理清，所有高级配置都是空中楼阁。
