Sublime Text需配合外部PHP工具链实现语法检查：先确保系统PATH中可调用php命令，再安装SublimeLinter及SublimeLinter-php插件，并在设置中显式指定php所在目录路径以解决GUI下PATH继承问题。

Sublime Text 本身不是 IDE，不内置 PHP 运行或语法检查能力；要实现“编写 PHP + 实时语法检查”，必须靠外部工具链配合插件，核心是让 php 命令可被 Sublime 调用，并通过插件（如 SublimeLinter-php）调用它。

确认系统已安装并能调用 php

这是所有后续步骤的前提。如果 php -v 在终端报“command not found”，任何插件都无效。

• macOS：用 Homebrew 安装后，确保 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）在系统 $PATH 中；Sublime 默认不读取 shell 的 PATH，需手动指定路径或改用 Login Shell 启动
• Windows：安装 XAMPP/WAMP 或独立 PHP 后，把 php.exe 所在目录（如 C: mppphp）加进系统环境变量 PATH，重启 Sublime
• Linux：多数发行版默认无 PHP CLI，运行 sudo apt install php-cli（Ubuntu/Debian）或 sudo dnf install php-cli（Fedora），验证 which php

安装 SublimeLinter 及其 PHP 插件

SublimeLinter 是框架，SublimeLinter-php 是具体执行 php -l（lint 模式）的插件。两者缺一不可。

• 用 Package Control 安装：快捷键 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）→ 输入 Package Control: Install Package → 分别搜索并安装 SublimeLinter 和 SublimeLinter-php
• 安装后默认启用，但需确保 PHP 文件保存时自动触发检查——检查 Preferences → Package Settings → SublimeLinter → Settings 中 "lint_mode": "save"（非 "background"，后者可能因 PATH 问题静默失败）
• 若仍无提示，打开 Sublime 控制台（Ctrl+`），查看是否有 php: command not found 类报错，即 PATH 未生效

配置 php_path 避免 PATH 失效

Sublime 在 GUI 环境下启动时，常无法继承终端的完整 PATH，导致插件找不到 php。此时需显式指定路径。

立即学习“PHP免费学习笔记（深入）”；

• 进入 Preferences → Package Settings → SublimeLinter → Settings
• 在用户设置（右侧面板）中添加：

  {
      "paths": {
          "linux": [],
          "osx": ["/opt/homebrew/bin"],
          "windows": ["C:\xampp\php"]
      }
  }
  

• 路径值填的是 php 所在**目录**，不是 php 文件本身；Windows 用双反斜杠或正斜杠均可
• 改完保存，重启 Sublime，新建 .php 文件，故意写错语法（如漏分号），保存看是否弹出错误提示

语法检查以外的实用补充

纯 lint 只报错，不补全、不跳转、不调试。若需要更多 PHP 开发支持，得叠加其他插件，但要注意冲突和性能：

• PHP Companion：提供 require/include 快速插入、类名自动补全，依赖项目根目录有 composer.json 或正确 phpcs 配置
• PHP Unit Test：运行测试，需本地已安装 phpunit 并可调用
• 避免装 PHP CodeSniffer 类插件却不配规则——它会拖慢保存响应，且默认规则（PEAR）和现代项目（PSR-12）差异大，容易误报

真正卡住的往往不是插件怎么装，而是 php 命令在哪、Sublime 能不能找到它。PATH 问题在 macOS 和 Windows 上表现隐蔽，但解决后，整个链路就稳了。