我完全懂你遇到的糟心事——删了$HOME/.gradle/caches/后，像RecyclerView这类依赖库的符号全飘红，连源码都看不了，试了清缓存重启、重建项目这些常规操作都没用，只有复制项目能搞定，但这显然不是长久之计。咱们来一步步拆解问题，不用复制项目也能彻底解决：

1. 彻底清理所有缓存（本地+项目级） #

有时候只删用户目录的Gradle缓存还不够，项目里可能残留了旧的缓存文件，导致同步逻辑异常：

• 先完全关闭Android Studio
• 再次执行你之前的命令清理用户级缓存：rm -rf $HOME/.gradle/caches/
• 进入项目根目录，删除.gradle文件夹（这是项目本地的Gradle缓存目录）
• 删除所有模块下的build文件夹，以及项目根目录的build文件夹

2. 强制Gradle重新下载依赖并构建 #

打开Android Studio后，在底部Terminal执行以下命令（Windows用户把./gradlew换成gradlew.bat）：

./gradlew clean build --refresh-dependencies

这个命令会做三件关键的事：

• 清理所有已生成的构建产物
• 强制Gradle忽略本地缓存，重新从远程仓库下载所有依赖构件和元数据
• 重新执行完整的构建流程，确保依赖被正确引入到项目中

3. 重置Android Studio的索引 #

有时候依赖已经下载成功，但IDE的索引没跟上，导致符号显示红色：

• 点击顶部菜单栏的File -> Invalidate Caches...
• 勾选Clear file system cache and local history选项
• 点击Invalidate and Restart，等待AS重启并重新索引整个项目

4. 检查依赖配置和仓库设置 #

确保你的依赖声明和仓库配置没有问题：

• 打开模块的build.gradle（比如app/build.gradle），确认RecyclerView的依赖声明正确，例如：

  implementation 'androidx.recyclerview:recyclerview:1.3.2'
  

• 检查项目根目录的build.gradle，确保仓库配置包含google()和mavenCentral()，这两个是Android依赖的主要来源：

  repositories {
      google()
      mavenCentral()
  }
  

• 如果之前用过代理或者镜像仓库，检查Settings -> Build, Execution, Deployment -> Gradle里的代理设置是否正常，避免依赖下载失败

为什么复制项目能解决？ #

复制项目相当于让Android Studio重新初始化整个项目的Gradle环境，重新触发依赖解析、下载和索引的完整流程，绕过了之前项目中可能存在的缓存残留或索引异常。而上面的步骤就是手动模拟这个流程，不用复制项目也能达到同样的效果。

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