最可靠方式是还原inspectionProfiles配置；项目级覆盖.idea/inspectionProfiles/下XML文件，IDE级覆盖~/.config/JetBrains/PhpStorm*/config/inspection/目录，导入.jar时须手动勾选colors、fileTemplates、liveTemplates、inspectionProfiles四项且禁用cache/system/plugins。
恢复 PhpStorm 语法检查设置，最可靠的方式是还原 inspectionProfiles 配置，而不是重装或盲目导入整个设置包——因为检查规则分散在项目级和 IDE 级两个位置，且容易被外部工具（如 phpcs）覆盖或缓存残留干扰。
确认当前 inspection 配置来源是项目级还是 IDE 级
PhpStorm 的语法检查行为由两套配置共同决定：
- 项目级 profile 存在
.idea/inspectionProfiles/下，以 XML 文件形式提交到 Git，影响所有协作者 - IDe 级 profile 存在
~/.config/JetBrains/PhpStorm2025.1/config/inspection/（路径随版本变化），仅影响本地
打开 Settings → Editor → Inspections，右上角下拉菜单显示 “Project Default” 表示你正在编辑项目级配置；若显示 “Default” 或 “PhpStorm2025.1”，则是 IDE 级。恢复前必须先分清目标。
从备份还原 inspectionProfiles 目录（推荐）
如果你有完整备份（比如压缩了 .idea 或 config 目录），直接解压覆盖对应位置即可，但要注意：
立即学习“PHP免费学习笔记（深入）”；
- 项目级：覆盖
.idea/inspectionProfiles/下的 XML 文件，无需重启，改完后按Ctrl + Shift + O重新索引当前文件立即生效 - IDe 级：覆盖
~/.config/JetBrains/PhpStorm2025.1/config/inspection/整个目录，覆盖前先关掉 PhpStorm，否则新配置可能被启动时自动重写 - 切勿只复制单个 XML 文件——
profiles_settings.xml控制 profile 激活状态，缺失会导致列表空白
用 .jar 导入时必须手动勾选四项关键项
通过 File → Manage IDE Settings → Import Settings 导入 .jar 包时，默认勾选项会跳过真正起作用的配置：
- 务必勾选
colors（影响检查高亮颜色）、fileTemplates（影响代码生成模板）、liveTemplates（影响快捷键补全）、inspectionProfiles（核心） - 绝对不要勾选
cache、system、plugins—— 这些会导致启动失败或插件冲突 - 导入后需重启，并在
Settings → Editor → Inspections中手动确认 Scope 是 “Project Default” 或 “Default”，再点Reload project from Disk
检查是否被 phpcs/phpstan 覆盖
即使 inspection 设置已恢复，仍看不到波浪线？大概率是外部 linter 抢占了提示权：
- 看警告图标：原生 inspection 提示无小图标；
phpcs显示PSR12小标，phpstan显示PHPStan标 - 关闭外部工具验证：进
Settings → Languages & Frameworks → PHP → Quality Tools，临时禁用所有勾选项 - 再回到
Inspections页面，单独启用PHP → Syntax error和PHP → Undefined variable等基础项，观察是否出现提示
真正难恢复的不是配置本身，而是那些没被显式保存的 Scope 绑定（比如你曾为 .phtml 单独建过 Scope 却忘了导出 pattern）；这类细节一旦丢失，只能靠日志回溯或重新配置。
