IntelliJ IDEA 编辑器为何突然不显示 inspection 高亮?
先检查文件分析级别和省电模式
先将受影响文件的 Highlight 级别设为 All Problems,并确认 File | Power Save Mode 处于关闭状态。Everywhere 只表示 inspection 的适用范围,不能保证编辑器会实时运行并显示这些检查。
手动检查能返回结果,说明至少参与本次手动分析的检查可以工作,不能证明编辑器的实时分析状态正常。目前的信息不足以确定唯一原因,也不能据此认定是 IntelliJ IDEA 2025.3.4 的版本缺陷。
1. 将当前文件设为 All Problems
打开一个确定存在问题的文件,将鼠标悬停在编辑器右上角的检查状态组件上,找到 Highlight 列表。也可以通过 Code | Analyze Code | Configure Current File Analysis… 打开相关设置。
检查当前选项:
None:关闭问题高亮。Syntax:只显示语法问题。Essential:输入时仅显示必要问题,保存文件后显示检测到的全部问题。All Problems:显示语法问题及 inspections 检出的问题。
将其设为 All Problems,等待分析完成,再查看之前能通过手动检查定位的问题。如果原来是 Essential,也可以先保存文件,观察提示是否出现。这些行为见 IntelliJ IDEA 2025.3 文件高亮设置说明。
这是文件级设置,需要在实际受影响的文件中确认。绿色勾号也要结合当前分析级别理解,不能单凭它断定所有 inspections 都已执行。
2. 关闭 Power Save Mode
在 File 菜单中检查 Power Save Mode。如果已开启,将其关闭,返回文件后等待后台分析。
该模式会停止包括实时 inspections 和错误高亮在内的后台操作,建议优先排查。JetBrains 的 IntelliJ IDEA 故障排查说明明确列出了这一影响。
3. 对照同一项 inspection 和同一个 profile
从手动检查结果中选一个具体问题,记录 inspection 名称和代码位置,再到 Settings | Editor | Inspections 检查:
- 当前使用的 inspection profile 是否与手动运行时选择的一致。
- 该项 inspection 是否启用。
- 针对该文件生效的 severity 是否为
No highlighting (fix available);如果是,可按需要改成Warning等可见级别。
No highlighting (fix available) 会保留检查及修复能力,但不显示对应高亮。恢复方法见 JetBrains 的 inspection 高亮说明。
还要确认该检查是否只能批量运行。在 Inspections 设置的筛选菜单中选择 Show only batch-mode inspections,可以查看这类规则。部分检查依赖全局代码分析,本来就不会在编辑器中实时执行,详见 IntelliJ IDEA 2025.3 手动检查说明。
如果以前会实时提示的多种问题同时消失,应继续检查编辑器的整体分析状态。
4. 用一个明确的问题验证恢复情况
最可靠的验证对象是原文件中的同一处问题:它以前会实时提示,现在仍能被手动检查检出。每次只改一个设置,等待分析完成后,观察提示是否恢复。
如果受影响的是 PHP 文件,也可以在临时文件中加入一个返回类型不匹配的示例:
<?php
function inspectionProbe(): int
{
return 'not an int';
}
这个示例可用于辅助观察 PHP 类型检查。是否产生提示仍取决于语言配置及对应 inspection 是否启用,不能将它作为所有文件类型的通用测试。验证后删除临时代码。
5. 设置正常时,再缩小故障范围
如果 All Problems、省电模式、profile 和 severity 都已确认正常,可以按以下顺序继续:
- 等待正在进行的项目分析完成,观察检查状态组件是否提示分析暂停或不可用。
- 在同一项目的另一个同类型文件中测试,再用最小项目对照,区分单文件、项目和整个 IDE 的问题。
- 如果仍可复现,暂时停用自行安装且非语言支持必需的插件,重启后对照。插件列表本身不能证明某个插件存在冲突。
- 如果有索引异常迹象,再考虑修复索引或失效缓存;不要一开始就删除
.idea或整个 IDE 配置目录。
提交故障报告时,附上准确 build、受影响文件类型、具体 inspection 名称、Highlight 设置截图,以及手动检查和编辑器显示的对照。日志没有错误只能说明当前没有找到相关记录,不能排除实时分析异常。
备注:内容仅供参考。
