添加自定义Lint规则后Android Studio陷入索引循环问题求助

我之前也碰到过类似的自定义Lint规则引发Android Studio索引无限循环的坑，结合踩过的雷和排查经验，给你几个实用的解决方向：

• 检查Lint规则的触发范围
  虽然你的规则目标是检查XML文件，但很可能在实现时不小心让它在Java文件编辑时也被触发了。比如：

  • 确认规则的getApplicableFileTypes()方法明确返回XmlFileType.INSTANCE，别让它覆盖到Java文件类型；
  • 检查规则的run()方法里有没有意外遍历到Java文件的逻辑，比如错误地扫描了整个项目目录而非仅XML文件，导致索引被反复触发更新。

• 优化Lint规则的性能
  性能低下的Lint规则会拖慢索引过程，甚至引发循环：

  • 避免在扫描时做大量IO操作或重复计算，尽量使用Lint提供的Context相关API获取资源，减少直接操作文件系统；
  • 对需要重复检查的内容加入缓存机制，比如用HashMap缓存已扫描过的文件结果，避免重复处理。

• 调整Android Studio的索引与构建配置

  • 打开Settings/Preferences → Build, Execution, Deployment → Compiler，取消勾选Build project automatically，自动构建有时候会和Lint扫描冲突，触发索引循环；
  • 进入Settings/Preferences → Editor → File Types，确认你的自定义规则没有错误地把Java文件标记为需要扫描的类型；
  • 彻底清除索引缓存：点击File → Invalidate Caches... → 选择Invalidate and Restart，这比单纯重启更能清理损坏的索引文件。

• 检查Lint规则的注册逻辑

  • 确认规则没有被重复注册，比如在lint.xml和自定义IssueRegistry里同时注册了同一个规则，重复扫描会触发索引反复更新；
  • 如果是通过Gradle插件引入的自定义Lint，检查插件配置是否在Java文件变更时就触发了Lint任务，调整触发时机为仅在构建或XML文件变更时执行。

内容的提问来源于stack exchange，提问作者nios