Sublime如何配置PHP语法检查？（Linter插件使用）-sublime-PHP中文网

应安装SublimeLinter与SublimeLinter-php组合；前者为框架负责高亮定位，后者为执行器调用php -l检查；需显式配置php路径并设"lint_mode": "save"避免卡顿。

sublime如何配置php语法检查？（linter插件使用）

PHP Linter 插件装哪个？别选错

Sublime Text 本身不带 PHP 语法检查，得靠第三方插件。现在能用且维护正常的只有 SublimeLinter + SublimeLinter-php 这套组合。别装 PHP-CodeSniffer 或老版本 SublimeLinter-PHP（已废弃），它们要么不兼容 Sublime 4，要么报 linter failed: command not found。

安装方式：Package Control → Install Package → 搜 SublimeLinter，装完再搜 SublimeLinter-php。两个必须都装，缺一不可。

SublimeLinter 是框架，负责高亮、定位错误位置
SublimeLinter-php 是具体执行器，调用系统里的 php 命令做 -l 检查
如果只装了前者，编辑器不会报错，但也不会标出任何语法问题

为什么改了 PHP 路径还是报 “php: command not found”？

插件默认调用系统 PATH 下的 php，但它不读取你的 shell 配置（比如 ~/.zshrc 里加的 export PATH）。Mac/Linux 用户常见于用 brew install php 装了新版，但 Sublime 是从 GUI 启动的，根本看不到你终端里的 PATH。

解决办法是显式指定 php 路径：

打开 Preferences → Package Settings → SublimeLinter → Settings

在右侧用户设置里加这段：

{
    "linters": {
        "php": {
            "executable": "/opt/homebrew/bin/php"
        }
    }
}

路径怎么找？终端运行 which php，结果直接复制进去
Windows 用户填类似 C:\xampp\php\php.exe，注意双反斜杠

保存时才检查 vs 实时检查，怎么选？

SublimeLinter 默认是“边写边检”，对 PHP 这种解释型语言容易卡顿，尤其文件稍大或有复杂嵌套时，光标会延迟、输入卡顿。这不是 bug，是它每敲一个字符都在调 php -l。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

建议关掉实时检查，只在保存时触发：

Settings 里加：
```
"lint_mode": "save"
```
避免误报：有些 PHP 文件依赖 $_SERVER 或全局常量，php -l 不加载环境，可能报 undefined constant —— 这不是代码错，是检查方式局限，不用理
如果真要实时，把 php -l 替成 phpstan 或 psalm 更靠谱，但那是另一套配置了

检查没反应？先看这三件事

插件装了、路径设了、保存也按了，但没红波浪线——大概率卡在基础环节：

确认当前文件右下角显示的是 PHP，不是 Plain text 或 HTML；点一下切换，或者快捷键 Ctrl+Shift+P → Set Syntax: PHP
检查文件后缀是不是 .php；.inc、.module 这类非标准后缀默认不触发 php linter
终端手动跑一次 php -l yourfile.php，看是否真报错；如果命令行也不报，说明文件语法没问题，插件没反应是正常的