Android Studio 3.1.1重启项目首次打开时R引用未解析问题求助

我之前在Win7环境下用老版本AS时也踩过这个坑，给你整理几个亲测有效的解决方案，按顺序试试应该能彻底搞定：

1. 清理Gradle缓存与构建文件 #

这是解决这类缓存问题最有效的第一步：

• 先关闭Android Studio，找到项目根目录下的.gradle隐藏文件夹，直接删除它
• 接着删除项目根目录的build文件夹，以及app模块下的build文件夹
• 重新打开AS，它会自动重新下载Gradle依赖并同步项目，这一步能清除绝大多数因缓存损坏导致的R文件生成异常

2. 调整AS的自动同步与编译设置 #

老版本AS的自动同步逻辑有时候会抽风，调整设置能避免每次打开都出问题：

• 打开File → Settings（Win/Linux），找到Build, Execution, Deployment → Build Tools → Gradle
• 取消勾选Offline work（避免离线模式导致依赖同步不完整），同时勾选Automatically sync after opening project
• 再切换到Compiler选项，确保未勾选Configure on demand，这个选项容易导致R文件生成延迟或不完整

3. 排查XML文件的语法错误 #

R文件无法正常生成的核心原因往往是XML文件有问题，哪怕是小错误都会导致R文件不生成：

• 打开底部的Messages面板，查看是否有XML相关的红色报错（比如标签未闭合、资源名重复、属性值写错）
• 修复所有XML文件的错误后，点击工具栏的Sync Project with Gradle Files按钮重新同步
• 重点检查res目录下的layout、values、drawable文件夹里的文件，这些是重灾区

4. 确认SDK路径与版本配置 #

路径或版本不匹配也会导致R文件生成异常：

• 打开File → Project Structure，检查SDK Location里的Android SDK路径是否是纯英文无特殊字符（中文、空格、感叹号都可能出问题）
• 同时检查Module Settings里的Compile SDK Version、Build Tools Version是否和项目根目录build.gradle里的配置一致，避免版本不兼容

5. 升级Android Studio（可选） #

Android Studio 3.1.1确实是比较老旧的版本了，官方后续修复了很多缓存和同步相关的bug：

• 如果上面的方法都无效，可以考虑升级到最新的稳定版（比如Arctic Fox或更高版本），升级前记得备份好项目文件

我当时就是用前两个方法就彻底解决了这个重复报错的问题，你可以按顺序尝试，应该能解决你的困扰！

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