为什么我的Android Studio项目一直显示‘正在分析文件’且IntelliSense无自动提示

适用场景 #

macOS Big Sur 11.2.1 + Android Studio 4.2.1 环境下，仅单一项目出现持续文件分析、无语法报错提示、无代码自动补全问题，已尝试失效缓存重启、关闭省电模式、重新克隆项目均无效，新建项目运行正常。

排查步骤 #

• 清理项目残留配置：关闭项目窗口后，删除项目根目录下的.idea文件夹、所有.iml文件，重新导入项目等待IDE重新生成配置并构建索引。若项目Git仓库中提交了.idea目录，需先将.idea加入.gitignore避免后续拉取再次触发异常。
• 校验Gradle版本匹配：Android Studio 4.2.1 稳定适配的AGP（Android Gradle 插件）版本为 4.2.0 ~ 4.2.2，对应Gradle版本为 6.7.1 ~ 7.0.2，若项目近期修改过Gradle相关配置导致版本超出适配范围，会触发索引进程异常。可在项目根目录build.gradle和gradle/wrapper/gradle-wrapper.properties中调整版本到适配范围后重试。
• 执行无缓存全量构建：在项目根目录执行终端命令 ./gradlew clean build --no-build-cache，完成一次跳过本地缓存的全量构建，排查是否存在隐藏的构建报错导致索引中断。
• 排查异常代码/插件：确认近期新增内容是否存在单文件超过1MB的超大代码文件、自定义代码生成插件输出的异常格式代码，这类内容会导致IDE索引进程卡住无法完成解析。
• 安装IDE补丁：Android Studio 4.2.1存在已知的索引异常Bug，可升级到4.2系列最新补丁版本修复已知问题。

故障截图 #

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