PAYATHON 2026

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 检查:

  1. 当前使用的 inspection profile 是否与手动运行时选择的一致。
  2. 该项 inspection 是否启用。
  3. 针对该文件生效的 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 都已确认正常,可以按以下顺序继续:

  1. 等待正在进行的项目分析完成,观察检查状态组件是否提示分析暂停或不可用。
  2. 在同一项目的另一个同类型文件中测试,再用最小项目对照,区分单文件、项目和整个 IDE 的问题。
  3. 如果仍可复现,暂时停用自行安装且非语言支持必需的插件,重启后对照。插件列表本身不能证明某个插件存在冲突。
  4. 如果有索引异常迹象,再考虑修复索引或失效缓存;不要一开始就删除 .idea 或整个 IDE 配置目录。

提交故障报告时,附上准确 build、受影响文件类型、具体 inspection 名称、Highlight 设置截图,以及手动检查和编辑器显示的对照。日志没有错误只能说明当前没有找到相关记录,不能排除实时分析异常。

备注:内容仅供参考。