PhpStorm实时代码检查未生效时，需依次启用全局检查、配置PHP相关Inspection规则、设置作用域、开启高亮与快速修复、重置缓存并重启索引。
如果您在PhpStorm中编写PHP代码时未看到实时的语法或潜在问题提示，则可能是实时代码检查功能未启用或相关Inspection规则被禁用。以下是开启并配置PhpStorm实时代码检查的具体方法：
一、启用全局实时代码检查
PhpStorm默认启用代码检查，但可能因设置被手动关闭而失效。需确认编辑器顶部状态栏是否显示“Inspections: On”，若显示为Off则需手动开启。
1、点击PhpStorm顶部菜单栏的File → Settings（Windows/Linux）或PhpStorm → Preferences（macOS）。
2、在左侧导航树中展开Editor，点击Inspections。
立即学习“PHP免费学习笔记（深入）”；
3、确认右上角的Inspect code automatically复选框已被勾选。
4、在右侧列表顶部，确认Profile下拉框中选择的是Default或其他已启用Inspection的配置文件。
二、启用项目级Inspection规则
即使全局检查开启，具体规则仍可能被单独关闭。每个Inspection规则可独立启用或禁用，并支持按语言、作用域和严重级别调整。
1、在Settings/Preferences → Editor → Inspections界面中，展开左侧树状结构中的PHP节点。
2、逐项查看子项如General、PHP Language Level、Undefined symbols等，确保所需规则前的复选框处于勾选状态。
3、对某项规则右键，可选择Change severity调整提示级别（如Warning、Error），或选择Suppress for file临时忽略当前文件。
4、若需恢复全部默认规则，点击右上角Manage profiles → Restore defaults。
三、配置代码检查作用域范围
PhpStorm允许将Inspection限制在特定文件、目录或文件类型中，避免误报或性能干扰。正确设定作用域可提升检查精准度与响应速度。
1、在Inspections设置页右侧，点击Only for files matching下方的…按钮。
2、在弹出窗口中输入文件匹配模式，例如：*.php（仅PHP文件）、src/**/*.php（src目录下所有PHP文件）。
3、点击Add保存模式，再点击OK确认作用域设置。
4、若需排除测试文件，可添加排除规则：tests/** 或 **/*Test.php，并勾选Exclude选项。
四、启用实时高亮与快速修复提示
开启Inspection后，错误或警告需在编辑器中实时高亮显示，并支持鼠标悬停查看详情及快捷修复。该功能依赖于后台分析进程与UI渲染协同工作。
1、在任意PHP文件中输入存在语法问题的代码（如未声明变量、缺失分号），观察行号右侧是否出现黄色或红色波浪线。
2、将鼠标悬停在波浪线下方，确认是否弹出提示框，内容包含问题描述与Quick-Fix链接。
3、按下Alt + Enter（Windows/Linux）或Option + Enter（macOS），验证是否列出可用的自动修复操作。
4、若无反应，返回Settings/Preferences → Editor → General → Highlighting level，确认设置为High或Medium。
五、重置Inspection缓存并重启索引
当规则已启用但仍未触发检查时，可能是本地索引损坏或缓存未同步。强制刷新可恢复Inspection引擎的正常响应能力。
1、点击PhpStorm顶部菜单File → Invalidate Caches and Restart…。
2、在弹出窗口中勾选Invalidate and Restart，点击确认。
3、等待重启完成后，打开一个PHP文件，观察状态栏是否显示Indexing…，待其消失后再次测试代码检查效果。
4、若仍无效，可尝试关闭所有插件（尤其是第三方PHP相关插件），再逐一启用排查冲突源。
