如何恢复PhpStorm检查规则设置-phpstorm-PHP中文网

phpstorm检查规则配置分三层：project级（.idea/inspectionprofiles/）、ide级（jetbrains配置目录）、shared级（如.phpstorm.meta.php）；优先级从高到低，误删或升级失效时需从对应位置恢复。

如何恢复phpstorm检查规则设置

恢复 PhpStorm 检查规则设置，核心不是“重装”或“默认还原”，而是找回你改过、关过、调过的那些 Inspection 配置项——它们藏在项目级或用户级配置中，一旦误删、覆盖或升级失效，就得从对应位置捞回来。

PhpStorm 的检查规则（Inspections）配置分三层，优先级从高到低：

Project 级：存于 .idea/inspectionProfiles/ 下的 XML 文件，只对当前项目生效；
IDE 级（Default）：存于 ~/.config/JetBrains/PhpStorm2025.1/config/inspectionProfiles/（macOS/Linux）或 %APPDATA%\JetBrains\PhpStorm2025.1\config\inspectionProfiles\（Windows），影响所有新项目；
Shared（通过 .phpstorm.meta.php 或外部工具注入）：不直接修改 Inspections UI 设置，但会叠加显示结果，容易混淆来源。

你“感觉规则没了”，大概率是其中一层被清空、覆盖或没加载。比如重装 IDE 后只恢复了插件，却漏掉了 inspectionProfiles 目录。

如果你只是在 Settings → Editor → Inspections 里点了取消勾选、清空 Scope、甚至删了自定义 Profile，IDE 会自动记录这些操作——只要没手动清理 Local History，5 天内都能回滚。

打开任意 PHP 文件，右键 → Local History → Show History；
在时间线中找带 Modified 或 Deleted 标记的条目，重点看最近 1–2 小时内的快照；
展开左侧文件树，定位到 .idea/inspectionProfiles/Project_Default.xml（项目级）或 .idea/inspectionProfiles/Default.xml（旧版路径）；
右键该文件 → Revert，确认后配置即恢复。

注意：Revert 是覆盖写入，如果当前已有同名文件，会被替换。建议 revert 前先复制一份 .idea/inspectionProfiles/ 备份。

PHP

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

下载

如果你有备份过的 .jar 设置包（比如重装前导出的），或者想把某台机器上配好的规则迁到新环境，这是最干净的方式——它能一次还原所有 Inspections 勾选状态、Scope 分配、自定义 Profile 名称和规则排序。

在源环境：进入 File → Manage IDE Settings → Export Settings，勾选 Inspections 和 Editor → Color Scheme（后者常关联检查高亮样式），导出为 settings.jar；
在目标环境：启动 PhpStorm 后，首次设置向导里选 Import settings from zip file；若已跳过向导，则用 File → Manage IDE Settings → Import Settings；
导入后无需重启，但需手动触发一次 File → Reload project from Disk，否则旧缓存可能让部分规则仍不生效。

别导入 Plugins 或 Keymaps，除非你明确需要——它们容易引发冲突，而 Inspections 是独立模块，可安全单独导入。

即使 Inspections 配置已还原，常见失效原因往往不在配置本身，而在作用域或缓存：

检查 Settings → Editor → Inspections 右上角的 Scope 下拉菜单：如果你在项目里改的是 Project Files，但导入的是 Default 配置，那规则不会自动套用到当前项目；
确认没有被外部工具覆盖：比如 phpcs 或 ESLint 的警告图标仍在右下角亮着，说明它们的提示正和内置 Inspections 叠加，此时标黄可能是外部工具报的，而非你刚恢复的规则；
强制刷新索引：按 Ctrl + Shift + O（Windows/Linux）或 Cmd + Shift + O（macOS）重新索引当前文件，或执行 File → Reload project from Disk 清掉整个项目的缓存。