Android Studio Gradle同步构建耗时10-15分钟,无法找到Offline Work设置
Gradle同步构建耗时过长的问题解决
10-15分钟的Gradle同步与构建耗时完全不正常,正常情况下模板项目的首次构建通常在5分钟以内(视网络和硬件配置而定),后续构建会更快。以下是具体的优化方案:
一、找到并启用离线模式(Offline Work)
Android Studio新版本(Arctic Fox及以后)调整了离线模式的位置,你可以通过两种方式找到:
- 方式1:点击右上角侧边栏的
Gradle面板(若未显示,通过View > Tool Windows > Gradle调出),面板顶部有个闪电图标,点击即可切换离线模式(hover时显示"Toggle Offline Mode")。 - 方式2:打开
File > Settings > Build, Execution, Deployment > Build Tools > Gradle,在右侧找到Offline mode勾选框并启用。
二、配置国内镜像源提速依赖下载
Gradle默认依赖仓库在国外,国内网络下速度极慢,替换为国内镜像能大幅缩短同步时间:
- 项目级配置:打开项目根目录的
build.gradle文件,修改repositories块:
repositories { maven { url 'https://maven.aliyun.com/repository/public/' } maven { url 'https://maven.aliyun.com/repository/google/' } maven { url 'https://maven.aliyun.com/repository/jcenter/' } google() mavenCentral() }
- 全局配置(所有项目通用):在用户目录下找到
.gradle/init.gradle文件(没有则新建),添加:
allprojects { repositories { maven { url 'https://maven.aliyun.com/repository/public/' } maven { url 'https://maven.aliyun.com/repository/google/' } maven { url 'https://maven.aliyun.com/repository/jcenter/' } google() mavenCentral() } }
三、升级Gradle与Android Gradle Plugin(AGP)版本
新版本的Gradle和AGP对构建性能做了大量优化,建议使用官方稳定版的最新版本:
- 在项目根目录的
build.gradle中,更新com.android.tools.build:gradle的版本到当前稳定版(如8.4.x); - 在
gradle/wrapper/gradle-wrapper.properties中,更新distributionUrl对应的Gradle版本,确保与AGP版本兼容(可参考Android Studio官方版本对应关系)。
四、启用Gradle构建缓存
Gradle构建缓存会复用之前的构建结果,大幅缩短后续构建时间:
打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle,勾选Build cache选项,选择Local即可(本地缓存足够日常开发使用)。
五、优化硬件与Studio配置
- 分配更多内存给Android Studio:打开
Help > Edit Custom VM Options,修改-Xmx参数,比如改为-Xmx4096m(根据电脑总内存调整,建议至少分配4GB); - 使用固态硬盘(SSD):SSD的读写速度远快于机械硬盘,能显著提升项目加载和构建速度。
内容的提问来源于stack exchange,提问作者Shourya Rajput
相关产品推荐
相关产品推荐

