2018 年在 IDEA 中遇到过:类明明存在,import 一直标红,但项目能正常编译打包。反复 build、rebuild 没有消除提示,最后通过清理 IDE 缓存并重启恢复。
这是一条索引排查线索,不意味着所有标红都应先清缓存。
先确认比较的是同一个工程
检查当前模块、分支、JDK、source root 和构建入口。命令行构建可能使用不同依赖或生成代码目录;一个模块打包成功,也不能证明另一个模块的编辑器模型正确。
对于 Maven/Gradle 工程,先按正常方式同步或重新导入配置,观察依赖和源目录是否正确识别。若确实缺依赖,应修复构建配置,而不是清掉错误提示。
再考虑索引与缓存
如果工程模型已对齐,编辑器仍无法解析构建可用的类,可以按当前 IDEA 支持的修复入口逐步处理。
需要重建缓存时,通常从 File > Invalidate Caches 进入,再根据提示选择重启。旧版本菜单曾写作 Invalidate Caches/Restart,名称可能不同。IDEA 缓存说明
执行前保存文件和必要备份,留意可选项。清理缓存可能影响该 IDE 版本的其他项目并需要重新索引;不要无意勾选删除 Local History 等额外数据。
结果要回到原问题验证
重启并等待索引结束后,重新打开同一文件,确认 import 解析和导航恢复,再确认构建仍通过。若问题很快重现,应继续查项目导入、插件和依赖模型,而不是反复把清缓存当成每次编译失败的固定步骤。