升级Android Studio 3.1与Gradle 4.4后打开内容时程序冻结
2026-5-25
解决Android Studio 3.1 + Gradle 4.4 打开项目/路径卡顿冻结问题
刚升级完就碰到这种卡死的情况确实糟心，我之前处理过不少类似的Gradle版本兼容问题，给你几个亲测有效的解决思路，按顺序试试：
清除Android Studio缓存，解决升级后缓存冲突
先彻底关闭Android Studio，找到对应的缓存目录：- Windows：
C:\Users\<你的用户名>\.AndroidStudio3.1\system - Mac：
~/Library/Caches/AndroidStudio3.1 - Linux：
~/.AndroidStudio3.1/system
删除目录里的caches和compiler文件夹，然后重启AS。这个操作能清除升级过程中残留的旧缓存文件，很多时候就能解决莫名的卡顿冻结。
- Windows：
切换Gradle离线模式，先规避远程版本校验问题
你还能打开欢迎向导的设置，那就先进入Build, Execution, Deployment > Gradle，勾选Offline work选项。这样AS会优先使用本地已下载的Gradle资源，不会去远程仓库校验版本，能避免因网络或版本不匹配导致的卡死。
之后可以用记事本手动打开项目根目录的build.gradle文件，把dependencies里的Android Gradle Plugin版本改成和Gradle 4.4匹配的3.1.4（Gradle 4.4对应AGP 3.1.0-3.1.4，3.1.4是这个分支的稳定版），修改后再尝试用AS打开项目。检查本地Gradle分发包是否损坏
找到Gradle的本地分发目录：- Windows：
C:\Users\<你的用户名>\.gradle\wrapper\dists\gradle-4.4-all - Mac/Linux：
~/.gradle/wrapper/dists/gradle-4.4-all
如果这个目录里的文件不完整或者有损坏，直接删除整个gradle-4.4-all文件夹，重启AS后它会自动重新下载完整的Gradle 4.4包，解决因本地包损坏导致的加载失败。
- Windows：
禁用第三方插件，排除插件兼容问题
升级后一些旧的第三方插件可能和Android Studio 3.1不兼容，导致程序卡死。进入欢迎向导的Plugins设置，把非官方的、暂时用不到的插件（比如主题插件、第三方代码检查工具）全部禁用，重启AS后再尝试打开项目。重置Android Studio配置，恢复初始状态
如果上面的方法都没效果，那就试试重置AS的配置：关闭AS后，找到配置目录：- Windows：
C:\Users\<你的用户名>\.AndroidStudio3.1 - Mac：
~/Library/Preferences/AndroidStudio3.1 - Linux：
~/.AndroidStudio3.1/config
把这个目录重命名（比如改成.AndroidStudio3.1_backup），然后重启AS，它会生成全新的配置文件，相当于恢复出厂设置。之后你可以重新配置自己的偏好设置，再尝试打开项目。
- Windows：
内容的提问来源于stack exchange，提问作者lavina
相关产品推荐
相关产品推荐
