怎么改某个检查项的严重等级（比如把“未定义变量”从 Error 降成 Warning）

直接改，不用重启，改完立刻生效。关键不是“能不能调”，而是调错位置会导致规则不生效——很多人在 Inspections 页面漏掉勾选“启用”，或者选错了配置文件。

• 按 Ctrl+Alt+S 打开设置，进 Editor → Inspections
• 左侧树展开 PHP → Undefined symbols，找到 Undefined variable
• 确保它前面的复选框是勾选状态（禁用后无论设啥等级都无效）
• 右侧 Severity 下拉菜单改成 Warning，不是 Error 或 Weak Warning
• 点 Apply，回到代码里试试：写个 $foo = $bar;，波浪线颜色会变浅

注意：Undefined variable 在用了 __get()/__set() 的类里常误报，这时候降级比关掉更安全——关了就真看不到其他地方的真实问题了。

为什么改了严重等级，编辑器里还是没高亮？

常见原因是高亮样式被覆盖或没配。严重等级只是“分类标签”，真正决定是否画波浪线、画什么颜色的，是背后绑定的高亮样式。

• 在 Inspections 设置页，选中某项（如 Unused local variable）后，看右侧面板里的 Highlighting in editor 下拉菜单
• 默认可能是 Background 或 Underline，但如果当前配色主题里这些样式被设成“透明”或“和背景同色”，就等于没高亮
• 点旁边的 Edit Highlighting，确认 Effect color 不是灰色或白色；也可临时换一个样式如 Wave underline 测试
• 另有一个隐藏开关：Settings → Editor → Color Scheme → General → Errors and Warnings，这里能统一关掉所有波浪线（别误点）

这个坑特别容易被忽略——你明明调了 Severity，却以为功能坏了，其实只是“画不出来”。

怎么让第三方库文件完全不检查？

不是靠降级，是靠排除作用域。对 vendor/ 或 node_modules/ 这类目录，设成 Exclude from inspection 才干净，否则 Warning 堆满侧边栏还拖慢扫描。

• 在项目视图里右键点击 vendor 文件夹 → Inspect Code…
• 弹窗右上角点齿轮图标 → 勾选 Exclude from inspection
• 或者进 Settings → Editor → Inspections，在右上角 Only for files matching 点 ...，加一条排除规则：vendor/**，并勾选 Exclude
• 验证方式：打开 vendor/autoload.php，故意写错语法，确认没有波浪线、也没有悬停提示

注意：用 Suppress for file 右键菜单只能单文件生效，对整个 vendor 目录无效；也别去手动关掉几十个 PHP 检查项——那是治标不治本。

怎么临时跳过某一行的检查（比如兼容旧代码）

用注释最准，但必须写对 ID。ID 错一个字母就不生效，而且不同版本 PhpStorm 的 ID 可能微调，不能凭记忆写。

• 把光标放在报错行，按 Alt+Enter，看弹出菜单里有没有 “Suppress for statement” 或 “Suppress for line”
• 选它，IDE 会自动生成类似 // @noinspection PhpUndefinedVariableInspection 的注释
• 如果要包一段代码，用 // @codeCoverageIgnoreStart 和 // @codeCoverageIgnoreEnd（注意不是所有检查都认这个，只对部分支持）
• 想查某个警告对应的 ID？鼠标悬停在波浪线上，工具提示第一行就是，例如：PhpUndefinedVariableInspection

别手写 PhpUnusedLocalVariableInspection 却贴在 undefined variable 的行上——注释不会报错，但也不会起作用，你会以为“屏蔽失败”，其实是 ID 不匹配。