PHP语法检查失效主因是php.validate.executablePath未正确配置或PHP CLI未加入PATH；需通过终端验证php --version和which php/where php，再在VS Code中手动设置绝对路径并重启。
PHP 语法检查在 VS Code 中不生效，大概率不是插件没装，而是 php.validate.executablePath 没配对，或者 PHP CLI 根本没进系统 PATH。
确认 PHP CLI 是否可用
VS Code 的 PHP 验证依赖本地安装的 PHP 可执行文件。如果终端里运行 php --version 报错或无响应，那 VS Code 肯定也调不动它。
- 在终端（macOS/Linux）或 CMD/PowerShell（Windows）中直接执行
which php（macOS/Linux）或where php（Windows） - 若无输出，说明 PHP 未正确安装，或安装后没加到系统 PATH
- Mac 用户用 Homebrew 安装过 PHP，路径通常是
/opt/homebrew/bin/php（Apple Silicon）或/usr/local/bin/php（Intel） - Windows 用户常见路径是
C:\xampp\php\php.exe或C:\php\php.exe
配置 php.validate.executablePath
VS Code 默认会尝试从 PATH 找 php，但多数失效场景都是它找不到——必须手动指定绝对路径。
- 打开 VS Code 设置（
Cmd+,或Ctrl+,），搜索php validate executable - 找到设置项
PHP > Validate: Executable Path - 填入上一步查到的完整路径，例如：
/opt/homebrew/bin/php或C:\xampp\php\php.exe - ⚠️ 注意：Windows 上必须写
.exe后缀，且反斜杠要双写或改用正斜杠（C:/xampp/php/php.exe更稳妥） - 改完后重启 VS Code，或右键 PHP 文件 → “Reload Window”
检查 PHP 插件是否启用且无冲突
官方 PHP 插件（PHP Intelephense 或 PHP Server）和旧版 PHP Extension Pack 可能互相压制验证功能。
立即学习“PHP免费学习笔记（深入）”；
- 禁用所有非必需 PHP 相关插件，只留一个主流的（推荐
Intelephense，它自带语法检查，比原生php.validate更准） - 如果坚持用 VS Code 内置验证（即
php.validate.enable设为true），请确保没同时开启intelephense.diagnostics.enable，否则报错会重复或覆盖 - 检查设置中
php.validate.enable是否为true（默认是 true，但可能被 workspace 设置覆盖） - 打开一个
.php文件，状态栏右下角应显示 PHP 版本号；若显示“PHP (disabled)”或空白，说明验证链断了
验证是否真生效
别只看有没有红波浪线——有些错误（比如未定义变量）默认不报，得靠实际触发语法错误来测。
- 在 PHP 文件里故意写一行非法语法，例如：
- 保存文件，看编辑器是否立刻标出
Parse error类提示 - 如果没反应，打开命令面板（
Cmd+Shift+P），运行Developer: Toggle Developer Tools，切换到 Console 标签页，看是否有类似Failed to spawn PHP process的报错 - 也可以在设置中临时开启
php.validate.run为onType（默认是onSave），让错误实时浮现
最常被忽略的一点：VS Code 工作区（.vscode/settings.json）里的 php.validate.executablePath 会覆盖全局设置，而且路径写错不会报错，只会静默失效。建议先清空 workspace 设置，用全局路径验证通了再逐步加回本地配置。
