Android Studio安装对应SDK源码后查看类源码出现类或方法缺失报错

问题根因 #

项目可正常编译是因为编译环节依赖SDK提供的编译用stub类库，和本地下载的仅用于查看的源码包互相独立。出现源码查看报错，本质是IDE对源码的索引匹配出错，或是源码版本和项目compileSdk版本存在偏差，也可能是IDE本地缓存损坏导致。

修复步骤 #

• 第一步核对版本匹配：打开模块级build.gradle文件确认compileSdk的版本号，再进入SDK Manager → SDK Platforms，勾选「Show Package Details」，确认对应API版本下的「Sources for Android XX」已完成安装，两者版本号完全一致。
• 第二步清理IDE缓存：点击顶部菜单栏File → Invalidate Caches...，在弹窗中勾选「Clear file system cache and local history」，选择「Invalidate and Restart」，等待IDE重启完成后重新打开源码文件即可。
• 第三步手动修复关联：如果上述操作无效，可进入File → Project Structure → SDK Location，确认Gradle JDK使用Android Studio默认内嵌的JDK，不要使用自行下载的外部独立JDK，避免版本兼容问题。
• 临时替代方案：如果仍无法修复，可直接点击源码查看窗口右上角的「Download Sources」按钮，重新拉取对应版本的源码包覆盖本地文件即可。

注：源码查看时的报错仅影响IDE语法提示效果，不会对项目的编译、打包、运行产生任何影响，不处理也不会阻碍正常开发。

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