PhpStorm PHP诊断失效主因是解释器配置错误、Language Level不匹配或Inspection被误关；需检查解释器路径及扩展、设置正确PHP版本、启用PHP检查项，并验证临时文件报错是否正常。
PhpStorm 默认已启用 PHP 代码诊断，但多数问题出在 PHP Language Level、Interpreter 配置错误或 inspection 被手动关闭——不是“没开”，而是“开得不对”。
确认 PHP 解释器是否正确配置
没有绑定有效的 PHP 解释器，phpstan、psalm、内置语法检查全失效，连 Undefined variable 都不会报。
- 打开
Settings/Preferences → Languages & Frameworks → PHP - 检查
Interpreter是否指向真实 PHP 可执行文件（如/usr/bin/php或C:\xampp\php\php.exe），不能是空或仅填版本号 - 点击右侧
...→Show All→ 选中解释器 → 点击Show interpreter details，确认能列出Extensions（尤其是tokenizer、json） - 若用 Docker / WSL，必须用
Remote Interpreter方式配置，本地路径映射不匹配会导致诊断静默失败
检查 PHP Language Level 和 Inspection 开关
Language Level 决定语法支持范围（比如 match 表达式在 8.0+ 才启用），而 Inspection 是具体规则开关，两者都错会导致“看着像没诊断”。
-
Settings → Languages & Frameworks → PHP中，Language level必须 ≥ 项目实际使用的 PHP 版本（如项目是 8.1，别设成 7.4） -
Settings → Editor → Inspections → PHP，确保顶部的Enable inspection已勾选 - 常见被误关的检查项：
Undefined variable、Unused symbol、PHP language level compatibility—— 它们默认开启，但容易在团队配置导入时被覆盖 - 若项目根目录有
phpstan.neon或psalm.xml，需在Settings → Languages & Frameworks → PHP → Quality Tools中显式启用对应工具，否则只走 PhpStorm 原生检查
验证诊断是否真生效：用最小例子测试
别依赖已有代码判断，直接新建一个临时文件，写几行必然触发警告的代码，看是否实时标红。
立即学习“PHP免费学习笔记（深入）”；
<?php $foo = 'hello'; echo $bar; // 这里应标黄并提示 "Undefined variable $bar" array_foobar([1,2]); // 应提示 "Function array_foobar not found" ?>
- 保存后，立刻观察编辑器左侧 gutter 和波浪线下划线；悬停可看到完整提示
- 若无反应，右键文件 →
Inspect Code…→ 选Current File，强制运行一次扫描，看结果窗是否有输出 - 如果仍无，检查
Settings → Editor → Color Scheme → General → Errors and Warnings，确认警告颜色未被设为透明或与背景同色
最常被忽略的是：PhpStorm 不会为 .php 文件以外的扩展名（如 .inc、.module）默认启用 PHP 检查，即使文件内容是 PHP。需要手动在 Settings → Editor → File Types 中把对应后缀关联到 PHP 文件类型。
