phpstorm php代码检查失效主因是php language level未设置或power save mode开启；需配置正确php解释器、匹配语言版本、启用unused symbol等关键检查项，并重载项目刷新索引。
PhpStorm 默认已启用基础 PHP 代码检查，但多数人实际没看到报错或提示，根本原因是 PHP Language Level 未正确设置或 Inspections 被手动关闭了。
确认 PHP 解释器和语言级别是否配置正确
没有有效的 PHP 解释器，PhpStorm 无法解析语法、识别函数签名，所有动态检查（如未定义变量、类型不匹配）都会失效。
- 进入
File → Settings → Languages & Frameworks → PHP - 检查
Interpreter是否指向真实 PHP 可执行文件（如/usr/bin/php或XAMPP\php\php.exe），不能是空或“None” - 确认
Language level与项目实际使用的 PHP 版本一致（例如项目用 PHP 8.1，就别选7.4，否则mixed类型、枚举等会被标红） - 若使用 Docker 或远程解释器，需确保路径映射（
Path mappings）准确，否则文件内跳转和检查会失灵
打开关键 PHP 检查项（尤其是被默认关闭的）
PhpStorm 默认只开部分低干扰检查，像「未使用的符号」「类型不兼容」「严格比较警告」这类实用项常处于关闭状态。
- 进入
Settings → Editor → Inspections → PHP - 勾选以下高频有用项：
Unused symbol、Strict comparison with ==、Missing argument、Undefined variable、Function is not found - 注意：子项（如
PHP → Code Style → Array declaration）属于格式建议，不影响逻辑检查，可按需开关 - 若整个 PHP 节点灰显，说明当前作用域不是 PHP 项目（比如没识别出
composer.json或没设置Sources Root）
让检查实时生效：避免缓存/索引导致延迟
改完设置后仍不报错？大概率是索引未更新或后台检查被暂停。
立即学习“PHP免费学习笔记（深入）”；
- 执行
File → Reload project from Disk强制重读文件 - 点击右下角
Indexing…状态栏，等待完成；若卡住，尝试File → Invalidate Caches and Restart → Invalidate and Restart - 检查右下角是否启用了
Power Save Mode（闪电图标）——开启后所有后台检查自动暂停，必须关闭 - 确保文件后缀为
.php且文件类型被识别为PHP File（右键文件 →Override File Type可查看/修正）
/**
* 示例：以下代码在正确启用检查后会立即标出两处问题
* - $name 未定义（Undefined variable）
* - array_key_exists() 第二个参数应为 array，传了 string（Type mismatch）
*/
if (array_key_exists('id', $name)) {
echo 'found';
}最常被忽略的是 Language level 和 Power Save Mode —— 一个决定能检查什么，一个决定检查是否运行。其他设置再细，这两项不对，全是白搭。
