如何离线安装Gradle并配置Android Studio使用离线版本
解决Gradle离线安装与Android Studio配置问题
别担心,我来一步步帮你搞定离线Gradle的设置,彻底绕开网络问题的困扰:
第一步:放置Gradle压缩包到指定目录
首先找到系统中Gradle wrapper的默认存放路径:
- Windows:
C:\Users\<你的用户名>\.gradle\wrapper\dists - macOS:
~/Users/<你的用户名>/.gradle/wrapper/dists - Linux:
~/.gradle/wrapper/dists
进入对应版本的文件夹(比如你截图里的gradle-7.5-bin文件夹),把你下载好的Gradle压缩包(比如gradle-7.5-bin.zip)直接放进去不要解压,如果文件夹里有未下载完成的临时文件,建议先删掉,避免冲突。
第二步:配置Android Studio使用离线Gradle
有两种方式可以配置,选一种适合你的即可:
方式1:修改项目的gradle-wrapper配置
打开你的Android项目,找到gradle/wrapper/gradle-wrapper.properties文件,修改distributionUrl字段为本地压缩包路径:
- Windows示例:
distributionUrl=file:///C:/Users/你的用户名/.gradle/wrapper/dists/gradle-7.5-bin/gradle-7.5-bin.zip - macOS示例:
distributionUrl=file:///Users/你的用户名/.gradle/wrapper/dists/gradle-7.5-bin/gradle-7.5-bin.zip - Linux示例:
distributionUrl=file:///home/你的用户名/.gradle/wrapper/dists/gradle-7.5-bin/gradle-7.5-bin.zip
保存文件后,重新同步项目(点击Android Studio右上角的「Sync Project with Gradle Files」按钮)即可。
方式2:全局设置Android Studio使用离线Gradle
如果你想让所有项目都用这个离线Gradle,可以在Android Studio里全局配置:
- 打开Settings(Windows:
File > Settings;macOS:Android Studio > Preferences) - 找到
Build, Execution, Deployment > Build Tools > Gradle选项 - 在「Gradle SDK」下拉框里,选择你已经下载好的Gradle文件夹(如果已经解压了压缩包的话);如果没解压,也可以通过「Add」按钮选择本地的Gradle压缩包
- 勾选「Offline work」选项(在同一页面的下方),这样Android Studio就会完全使用本地资源,不再尝试联网下载
注意事项
- 确保你下载的Gradle压缩包版本和项目
gradle-wrapper.properties里指定的版本完全一致,比如gradle-7.5-bin.zip对应配置里的gradle-7.5-bin,版本号不能错 - 如果同步时还是有问题,可以尝试清理项目缓存:
File > Invalidate Caches... > Invalidate and Restart
内容的提问来源于stack exchange,提问作者David Essien




