Android Studio+Gradle开发报错：Stub index points to a file without PSI

这个错误我之前在折腾Gradle同步、升级IDE甚至导入新项目时都碰到过，本质上是Android Studio的索引或缓存损坏，导致IDE无法正确识别某些文件类型。下面是几个亲测有效的解决方法，按优先级尝试：

• 清理并重启IDE缓存
  这是最直接的修复方式，绝大多数情况下都能解决问题：

  1. 打开Android Studio，点击顶部菜单栏的 File → Invalidate Caches...
  2. 在弹出的对话框里勾选 Invalidate and Restart，等待IDE自动重启并重新构建项目索引

• 删除Gradle本地缓存
  如果IDE缓存清理没用，试试清理Gradle的本地缓存，很多Gradle相关的异常都能通过这个方式解决：

  1. 先完全关闭Android Studio
  2. 找到Gradle缓存目录：
     • Windows系统：C:\Users\<你的用户名>\.gradle\caches
     • Mac/Linux系统：~/.gradle/caches
  3. 删除该目录下的所有内容，然后重新打开Android Studio，触发Gradle同步（IDE会自动重新下载所需的依赖）

• 检查并修复异常文件
  有时候是项目里存在IDE无法识别的文件（比如无扩展名的文件）导致的：

  1. 排查项目中是否有后缀不明确的文件，给它们加上正确的扩展名（比如.java、.kt、.xml等）
  2. 如果某个文件始终被识别为未知类型，右键点击它，选择 File → File Type，手动指定对应的文件类型

• 重新导入项目
  如果上面的方法都无效，可以尝试彻底重新导入项目，让IDE重新初始化所有配置：

  1. 关闭当前项目，回到Android Studio的欢迎界面
  2. 选择 Import Project，重新选中你的项目文件夹，按照引导完成导入流程

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