PhpStorm 实时代码检查默认开启，需确认文件被识别为PHP、项目设为Sources Root、PHP语言级别匹配，并在Inspections中启用Project作用域的未使用变量等弱警告项。
怎么打开 PhpStorm 的实时代码检查
phpstorm 默认开启代码检查，但如果你没看到波浪线或侧边栏提示，大概率是关了。关键不是“怎么启用”，而是“检查是否在正确作用域生效”。
常见错误现象：Undefined variable 不报、Unused parameter 没提示、函数调用后没补全提示——这些往往不是检查器坏了，而是当前文件没被识别为 PHP 文件，或项目语言级别不匹配。
- 右键项目根目录 → Mark Directory as → Sources Root（否则
include和命名空间解析会失效） - 确认
File → Settings → Languages & Frameworks → PHP中已设置正确版本（如 8.1），否则mixed类型或属性提升（public string $name;）会被误标为错误 - 检查右下角状态栏是否显示
PHP而非Text或Plain Text；如果不是，右键文件 → Override File Type → PHP
警告和错误为什么没在编辑器里显示
不是所有警告都靠波浪线呈现。PhpStorm 把问题分三类：错误（红色）、警告（黄色）、弱警告（灰色虚线）。默认弱警告常被关闭，比如 Variable is never used 或 Redundant 'else'。
使用场景：你改完一段逻辑，删了某个变量，但编辑器没提示——大概率它被归为“弱警告”且未启用。
- 进
Settings → Editor → Inspections，搜索关键词如unused、redundant、phpdoc，勾选对应项 - 注意作用域：勾选框右侧有下拉菜单，选
Project而非Default，否则只影响新建项目 - 某些检查（如
PHPDoc校验）依赖@param注释格式，若你写的是// @param风格，它不会触发
快速修复 Undefined variable 类错误
这类错误最常出现在模板文件（.phtml）、eval() 字符串、或动态变量名场景。PhpStorm 不会执行代码，只能静态推断——所以它“不知道”$user 是从 extract($data) 来的。
立即学习“PHP免费学习笔记（深入）”；
参数差异：不是所有变量都能靠 /** @var Type $name */ 解决，尤其当变量来自数组键或魔术方法时。
- 在变量前加注释：
/** @var User $user */，然后敲Alt + Enter应用修复 - 对
$_GET['id']这类超全局变量，PhpStorm 默认认识；但$config['db']['host']不行，需手动标注数组结构：/** @var array{db: array{host: string}} $config */ - 避免用
$$varname动态变量，PhpStorm 几乎无法推断，会持续报Undefined variable
Inspector 结果太多，怎么聚焦真正要修的问题
刚打开检查时满屏黄色波浪线，容易误以为“项目很烂”。其实多数是风格类警告（比如空格、换行、括号位置），和运行安全无关。
性能影响：开启全部检查项会让大型项目索引变慢，尤其启用 PHPStan 或 Psalm 集成时，卡顿明显。
- 优先开启硬性检查项：
Undefined variable、Undefined method、Missing return statement、Deprecated function - 关闭纯风格项：
Trailing spaces、Line break after opening brace（这些交给Code → Reformat Code或 ESLint/PHP-CS-Fixer 更合适） - 临时隐藏某行检查：在行尾加
// @noinspection PhpUnusedLocalVariableInspection（注意 inspection 名必须拼写准确）
真正麻烦的是跨文件类型推断失效——比如一个工厂类返回 new $class，PhpStorm 看不出具体类型。这种没法靠 Inspector 修，得靠 PHPDoc 显式标注返回值，或者重构掉 new $class。
