彻底禁用 inspection 需在 Settings → Editor → Inspections 中选对 Scope 后取消勾选规则，而非点击 Disable；标黄可能源于外部 linter 或缓存，需检查 External Tools、SonarLint 设置或重索引。

怎么真正关掉一个 inspection，而不是“假装看不见”

取消勾选 Inspections 列表里某项前的复选框，才是彻底禁用；点右下角 Disable 只是临时忽略当前文件，下次打开还亮着。关键看 Scope 是否匹配——如果你正在编辑的文件被标记为 Test Sources，而你在 Default Scope 下关了检查，它在测试文件里依然生效。

• 进 Settings → Editor → Inspections，左侧展开到具体规则（比如 PHP → Foreach by reference used）
• 确保顶部 Scope 下拉菜单选的是你目标作用域（Default 全局关，或项目名只关当前项目）
• 取消规则前的勾选，不是点右侧 Disable 按钮
• 改完后，若标黄没消失，先按 Ctrl + Shift + O（macOS Cmd + Shift + O）强制重索引当前文件

为什么关了 inspection 还标黄？缓存和外部工具在捣鬼

标黄 ≠ inspection 在工作。可能是旧分析结果残留，也可能是 phpcs、phpstan 或 SonarLint 正在叠加输出——它们各自独立运行，但 UI 上都画波浪线，颜色图标却不同（phpstan 带小盾牌，SonarLint 带 S 字标）。

• 先确认警告文字是否出现在 Alt + Enter 菜单里：如果菜单里没有对应 suppression 项，大概率不是 PhpStorm 自带 inspection，而是外部 linter
• 查 Settings → Tools → External Tools，看是否有 phpcs、phpmd 等配置被启用
• 查 Settings → Editor → Inspections 搜索 SonarLint，确认 Enable SonarLint analysis 是否勾选
• 删掉 .idea/misc.xml 里的 inspectionProfiles 节点再重启，可清空 inspection 缓存

怎么让 inspection 只对 .php 生效，放过 .phtml 和模板文件

PhpStorm 的 inspection 不按扩展名过滤，得靠 Scope 规则匹配。写错 Pattern 会完全失效——**/*.php 在部分版本不认，file:**/*.php 才是可靠写法。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

• 在 Inspections 页面右上角点 + 新建 Scope，命名如 PHP only
• Pattern 填 file:**/*.php（注意 file: 前缀不能少，** 表示递归）
• 回到 inspection 列表，找到目标规则，在右侧 Scope 下拉菜单中选刚建的 PHP only
• .phtml、.blade.php 文件即使含 PHP 代码，也不会触发该规则

哪些 inspection 容易误报，建议直接降级或关闭

框架项目里，Undefined field、Undefined method、Unused symbol 这三类最常吵闹。它们基于静态分析，但 Laravel/Symfony 的魔术方法、容器绑定、动态属性根本没法 100% 推断。

立即学习“PHP免费学习笔记（深入）”；

• Undefined field 和 Undefined method：进设置，勾选 Downgrade severity if __magic methods are present in class，或直接取消 Notify about access to a field via magic method
• Unused symbol：全局关风险高，建议用 // @noinspection PhpUnused 行内压制，尤其对工厂返回的动态对象
• Foreach by reference used：明确需要引用修改时，关掉比加注释更干净
• 所有涉及 dynamic、magic、__call、__get 的检查项，优先考虑降级为 Info 而非 Warning

真正难的不是找到开关，而是判断哪条规则该留、哪条该关、哪条该调成 Info——这取决于你的项目是否重度依赖魔术方法、是否接入了 Psalm/PHPStan 等更强的分析器。别贪全关，留几条核心的（比如语法错误、未定义函数）比全关更安全。