Android Studio下载慢？用阿里云镜像源加速Gradle、SDK与依赖仓库配置指南-AI智能范式网

Android Studio下载慢？用阿里云镜像源加速Gradle、SDK与依赖仓库配置指南

六三门·2026-09-24·阅读 22 GEO检测（免费）

Android StudioGradle阿里云镜像

|难度：普通|阅读约 36 分钟

新手安卓开发卡在"下载"这一步太正常了。我见过不少人第一次打开Android Studio，同步项目时盯着进度条半小时不动，心态直接从"我要学开发"变成"我为什么要遭这个罪"。实际上这不是你电脑不行，也不是代码有问题，就是默认下载通道在国外，国内访问经常抽风。这篇文章就围绕如何把Android Studio相关的下载全部切换到阿里云镜像源，把那些"卡到崩溃"的环节逐一拆开，给出可以直接照抄的配置。

我自己最开始也是从官方源一点点等过来的，后来踩过各种坑、查过各种帖子，才整理出一套相对完整的加速方案。这里说的不只是IDE安装包，还包括Gradle发行版、依赖仓库、Android SDK组件这些隐藏关卡。一次配置好，以后新建项目都能少受罪。

1. 为什么下载能慢到崩溃：先把病灶摸清楚

1.1 慢的不只是安装包，是三个环节

很多人以为"Android Studio下载慢"就是安装包那一下的事，其实坑在后面。

按我这几年的经验，Android开发环境默认会访问三类国外地址：

下载IDE安装包时，走的是dl.google.com，要么快要么压根连不上，完全看运气；
首次同步项目时要拉Gradle发行版，走的是services.gradle.org，动手动到一半卡死太常见；
项目里引用的依赖库和插件，默认从google()、mavenCentral()、gradlePluginPortal()这几个仓库拉，这些仓库主节点都在海外，国内请求经常超时。

这三件事叠在一起，给了新手的体验就是：安装要磨蹭半天，装完创建项目又要等半天，依赖解析再来一轮，每一个环节都像在开盲盒。下载慢不是玄学，说白了就是跨海网络对这类大文件、小散文件的传输不友好，尤其小文件多的时候，跟海外仓库建立连接的延迟、断连重试的成本都会被无限放大。

1.2 镜像源到底是个什么原理

用一个不恰当但好懂的类比：官方仓库相当于一个海外原厂仓库，你每次买零件都要去海外提货；镜像源就是国内有人把这个仓库完整复制了一份，放在离你更近的地方。你下单后从国内提货，传输链路短了，速度自然快。

阿里云Maven镜像就是把Maven生态下的常用Java依赖、Google Android组件、Gradle插件等缓存到国内节点。它解决的不是"给你加速某一个下载任务"，而是直接把"下载地址"换成了国内节点。配置到位后，Android Studio在解析大部分常见依赖时都能走本地高速通道。

下面这张表是我的直观感受，不同地区和网络环境会有差异，但整体趋势差不多：

下载对象	默认地址	不使用镜像的体验	推荐替代方式
IDE安装包	dl.google.com	经常几KB/s或直接断	清华TUNA镜像等
Gradle发行版	services.gradle.org	进度条卡半天的常客	腾讯软件源镜像
Android SDK组件	dl.google.com	时快时慢，晚上经常崩	官方直连或阿里云repository
项目依赖库/插件	google()等官方仓库	新项目首次Build十几二十分钟	阿里云Maven镜像

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 核心操作：给Gradle装上阿里云加速器

2.1 先分清：新项目和老项目要改的文件不一样

这一步最容易搞混。Android Studio从Dolphin版本之后创建的默认项目，仓库配置已经挪到了settings.gradle文件里，采用dependencyResolutionManagement和pluginManagement两段式结构；而网上大量老教程讲的都是改根目录下build.gradle的allprojects，这是老项目的写法。

如果你把老教程的allprojects加进新项目里，会出现仓库管理模式冲突：新项目默认使用RepositoriesMode.FAIL_ON_PROJECT_REPOS，意思是"禁止子项目自定义仓库"，一旦发现你在模块里又写了仓库配置，同步时会直接报错。

所以我的建议是：

新项目或Kotlin DSL项目，优先改settings.gradle；
老项目、或者不确定项目创建机制的，改根build.gradle里的allprojects；
想一步到位省事的，用全局init.gradle，下文专门讲。

2.2 settings.gradle配置长这样

我用Groovy DSL的写法，这是Android Studio新建项目最常见的默认格式：

groovy复制pluginManagement {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        google()
        mavenCentral()
    }
}

这一大段看着啰嗦，其实逻辑很清楚：

pluginManagement管的是Gradle插件、构建脚本依赖，也就是项目里声明的com.android.application这类插件的来源；
dependencyResolutionManagement管的是你代码里implementation 'androidx.core:core-ktx:1.x.x'这类依赖库的来源。

两个模块我都把阿里云镜像放在了前面，官方仓库放在了后面兜底。有的教程会让你把官方仓库全删了，只留阿里云，我试过，大多数情况下也能跑，但碰到镜像同步滞后、某个冷门版本没有及时拉取时，后面没有一个兜底仓库就会直接构建失败，所以保留官方源在列表末尾更稳妥。

2.3 三个镜像地址分别是什么来头

阿里云Maven镜像有几个不同的仓库地址，性质不同，别一骨碌全写上去还觉得无所谓：

镜像地址	对应官方仓库	用途
`https://maven.aliyun.com/repository/google`	Google Maven	AndroidX、AGP插件、Play Services等
`https://maven.aliyun.com/repository/gradle-plugin`	Gradle Plugin Portal	Gradle插件市场
`https://maven.aliyun.com/repository/public`	Maven Central + JCenter合并	大部分开源Java库
`https://maven.aliyun.com/repository/central`	Maven Central	单独指定中央仓库

默认情况下用google + public + gradle-plugin三件套就够了。public是阿里云把中央仓库与历史JCenter内容做了合并后的集合，对老项目特别友好；新项目如果全部依赖都在Maven Central上，用central可能比public的索引更新更快。

2.4 老项目的写法怎么兼容

如果你手上的项目还在用老式的全局仓库管理，打开根目录下的build.gradle，找到allprojects或subprojects块，改成：

groovy复制allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        google()
        mavenCentral()
    }
}

这里多提一句：老项目里如果还留着jcenter()这样一个仓库，建议去掉。JCenter早在2021年就停止服务了，很多老依赖虽然还能从历史存档里翻到，但新发布的包永远不会再同步。很多老项目迁移后"依赖解析慢""找不到新依赖"的毛病，一半是仓库配置本身的锅。

2.5 全局init.gradle：一次配置，所有项目生效

如果你经常从GitHub拉别人的项目、频繁新建项目，不想每个项目都手动改一遍仓库，可以配置Gradle全局初始化脚本。

路径如下：

Windows：C:\Users\你的用户名\.gradle\init.gradle
macOS/Linux：~/.gradle/init.gradle

没有这个文件就新建一个。内容可以这样写：

groovy复制allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
    }
}

这个脚本的作用是在每个Gradle构建启动时，自动给所有项目注入阿里云镜像仓库。不过要提醒一句：它起的是"追加仓库"的作用，项目自己的settings.gradle里配置的仓库依然存在，最终构建时会逐个尝试。有了这个兜底，即使别人给你的项目里写的是官方地址，镜像仓库也会作为候补参与解析，成功概率大大提升。

真正跑起来之后，你会发现日志里依赖的下载地址经常会变成maven.aliyun.com相关链接，官方源只会在镜像源没有命中时才被访问。这个效果就是我说的"一次配置，到处提速"。

3. 还有两个隐藏大坑：Gradle发行版和Android SDK组件

3.1 改完镜像项目还在卡？去看Gradle发行版

每次新建或导入项目时，Android Studio都会根据项目里的gradle/wrapper/gradle-wrapper.properties文件下载对应版本的Gradle。注意，这个下载和上面说到的依赖仓库完全是两码事。

很多人的同步卡住，就是卡在Downloading gradle-7.4-bin.zip这一步。这时候控制台一般会这样显示：

code复制Downloading https://services.gradle.org/distributions/gradle-7.4-bin.zip

解决方案是手动把Gradle发行版的下载地址改成国内镜像。最常用的替代是腾讯软件源的Gradle镜像：

properties复制distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-7.4-bin.zip

这里有几个关键点：

这个文件在项目根目录的gradle/wrapper/下面，注意文件路径要对应你项目实际使用的Gradle版本；
版本号一定要和原配置保持一致，比如原来是gradle-7.4-bin.zip，就换成相同版本的镜像地址，不要顺手升级版本，否则可能因AGP不支持而报错；
改完以后，如果旧的发行版下载了一半导致缓存损坏，建议把用户目录下~/.gradle/wrapper/dists里对应的版本文件夹删掉，再重新同步。

阿里云目前没有专门分发Gradle二进制发行版的镜像目录，所以这一环我通常用腾讯软件源补位。两个镜像使用场景不同，不冲突：阿里云管依赖库，腾讯镜像管Gradle本体下载。

3.2 首次运行的add-on list报错怎么处理

不少新手第一次安装完Android Studio，启动时会遇到一个报错窗口：

code复制Unable to access Android SDK add-on list

这个报错的本质是Android Studio试图访问Google的SDK组件列表来获取可下载的SDK版本信息，结果因为网络问题超时了。它本身并不影响进入Android Studio主界面，但会吓到新手。

正确的姿势是：

看到报错后直接点Cancel或Skip进入主界面；
在主界面通过More Actions -> SDK Manager进入SDK管理窗口;
勾选需要的Android平台版本，再点击Apply下载；
如果SDK Manager列表本身加载不出来，再考虑把SDK镜像地址配置进去。

SDK组件列表和依赖仓库虽然是两码事，但网上很多人会混淆。简单记住：依赖仓库是给Gradle解析用的，SDK仓库是给Android Studio下载平台组件用的，两者都可以指向阿里云镜像，但属于不同的配置入口。

3.3 SDK组件下载慢，可选的镜像方案

Android SDK平台的默认下载地址是dl.google.com。这些年Google在国内专门做了CDN加速，很多地区直连已经能跑满带宽。但如果你所在网络环境依旧很慢，还是可以配置镜像。

常见做法是在SDK Manager的设置里修改"SDK Updates Sites"或通过XML仓库地址指定镜像。阿里云也提供了Android仓库镜像：

code复制https://mirrors.aliyun.com/android/repository/

清华的镜像也可以作为备选：

code复制https://mirrors.tuna.tsinghua.edu.cn/android/repository/

但以我个人的实测体验，阿里云这个Android仓库的更新频率不算稳定，有时会有一段滞后。所以我的选择顺序是：先试官方直连，官方明显龟速时再用镜像。上来就换镜像，反而可能因为XML校验失败或版本列表过旧导致下载失败。

另外，SDK组件下载中途失败留下的临时文件很坑。如果下载连续失败，建议删除SDK目录下的.temp文件夹，再重新尝试。很多时候你以为自己要配镜像，其实只是上次下载的残留文件把新任务卡住了。

4. 从安装到首次Build的完整实战串一遍

4.1 安装包本身怎么下载更稳

前面说的都是项目里的下载，但安装包这一关不少人同样会被卡一下。

最简单的办法：访问Android Studio官网https://developer.android.com/studio，点击下载按钮。浏览器会自动跳转到dl.google.com。如果这个地址直接打不开或很慢，别在官网页面干等，复制下载链接，换清华TUNA镜像站下载：

code复制https://mirrors.tuna.tsinghua.edu.cn/AndroidStudio/

这里会按版本列出安装包，选择合适的平台版本即可。我个人不太建议从第三方网盘下载来路不明的安装包，涉及安全性的问题，没必要为了省几分钟去冒这个险。

安装时的两个细节：

安装路径不要带中文，也不要带空格，D:\Android\Android Studio这种比较省心；
如果之前没有单独安装过SDK，安装过程中选择是否下载SDK组件时，可以先跳过，等进入IDE后再用SDK Manager单独处理，这样不会因为SDK下载失败导致整个安装流程卡死。

4.2 新建项目的完整时间线

我以一台普通配置的Windows电脑为例，把从打开Android Studio到项目首次构建完成的时间线串一遍，方便你判断自己在哪一步耗时异常：

打开IDE，首次启动跳过导入设置，选择标准安装；
进入欢迎页后如果提示SDK缺失，先通过SDK Manager下载对应版本的Android SDK Platform；
新建Empty Views Activity或Empty Activity项目；
创建完成后，Gradle会先读取gradle-wrapper.properties下载对应版本Gradle发行版，正常情况下这里走镜像大概1到3分钟；
Gradle启动后解析插件和依赖，日志里能看到大量maven.aliyun.com的下载请求，首次构建大概2到5分钟；
构建成功后会继续下载Android SDK Build-Tools等组件，这一阶段取决于缺少的组件数量。

全程下来，如果网络正常且镜像配置到位，从新建项目到跑出第一个Hello World，一般在10分钟以内可以完成。如果某一个环节超过5分钟纹丝不动，那一定是配置没生效或走错了下载通道，别干等，直接看Gradle Console日志。

4.3 怎么看日志确认镜像生效

很多人在改完配置后不知道到底有没有生效，只能靠感觉。其实方法很简单：

在Android Studio底部打开Build窗口，同步项目时观察输出的下载链接。

如果出现这种情况，说明镜像生效了：

code复制Download https://maven.aliyun.com/repository/public/...
Download https://maven.aliyun.com/repository/google/...

如果日志里还是dl.google.com、services.gradle.org、repo.maven.apache.org这些官方地址，那说明你的配置根本没被加载，或者你改错了文件、改完后没有重新同步。

还有一个常见的小坑：有些项目为了加速，会在gradle.properties里设置org.gradle.offline=true，离线模式下Gradle不会发起任何网络请求，自然也不会去镜像站拉取新依赖。如果多次同步后提示找不到依赖，先检查这个配置项有没有悄悄被打开。

5. 镜像配置后的常见"水土不服"和排错

5.1 缓存冲突：改完配置还是走老地址

很多人会有这种感觉：明明镜像配置好了，为什么还卡？其实二进制包和依赖库都有缓存机制，Gradle不会无脑每次重新下载。

Gradle发行版的缓存路径在~/.gradle/wrapper/dists下，每个版本一个目录，目录后面还带一长串哈希值。同一版本的Gradle从不同地址下载，会生成不同的哈希目录。如果你从官方地址下载到一半失败了，残留在缓存目录里的文件不会自动失效，只有完整下载完成后才会被正常使用。

依赖库的缓存则在~/.gradle/caches下。当你从官方地址换成镜像地址后，Gradle会重新检查远程仓库的元数据，如果镜像上存在对应版本，就会重新拉取；但如果之前的请求被Gradle判定为"这个地址已确认不可用"，它会缓存这个失败结果一段时间，导致你改完配置后第一次同步仍然报错。

这时候可以试试清理Gradle缓存。但我不建议一味把整个caches目录删掉，那会导致很多已经下好的依赖重新下载，白白浪费时间。优先用命令行参数刷新：

bash复制gradlew build --refresh-dependencies

如果这条命令无效，再考虑删除具体的失败目录，比如~/.gradle/caches/modules-2/files-2.1里对应groupId的目录。

5.2 镜像找不到新版依赖：阿里云镜像同步滞后怎么办

阿里云Maven镜像本质上是一个代理缓存仓库，它需要从上游同步最新版本的库。如果你用的依赖刚发布一天，镜像上可能还没有收录，Gradle就会报类似这样的错误：

code复制Could not find androidx.core:core-ktx:1.15.0.

碰到这种问题，先别怀疑是镜像配置错了。我的处理习惯是：

先确认该依赖的版本号是否真的存在，去Maven Central或Google Maven搜一下；
如果版本确实存在，但镜像上没有，最简单的方法是把对应官方仓库从列表末尾挪到前面，或者保留官方仓库不删，让它作为兜底去拉取这个特定版本；
如果这个版本太新、不稳定的可能性较大，直接换用稳定版依赖，很多alpha、beta版本根本没必要追。

另外还有一个细节：public镜像合并了Central和JCenter的内容，但单独指定central镜像往往同步更快一点。如果public上拉不到某个库，可以尝试在仓库列表里增加central镜像：

groovy复制maven { url 'https://maven.aliyun.com/repository/central' }

5.3 Kotlin DSL和Groovy DSL写法混淆

现在很多新项目用的是Kotlin DSL，也就是settings.gradle.kts文件。它的仓库写法和常见教程里的settings.gradle不一样，如果你直接照搬Groovy语法，会直接编译报错。

正确写法是用url = uri(...)：

kotlin复制pluginManagement {
    repositories {
        maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
        maven { url = uri("https://maven.aliyun.com/repository/google") }
        maven { url = uri("https://maven.aliyun.com/repository/public") }
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url = uri("https://maven.aliyun.com/repository/google") }
        maven { url = uri("https://maven.aliyun.com/repository/public") }
        maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
    }
}

Kotlin DSL对类型的校验比Groovy严格得多，经常因为漏了uri()包装直接报"类型不匹配"。看到类似的错误提示，先检查是不是写法问题。

5.4 配置了镜像后反而变慢的另类原因

镜像源也不一定是万能的。阿里云Maven在国内有多个节点，正常情况下比官方仓库快得多，但偶尔也会因为网络链路波动变慢。如果配置镜像后依然很慢，还有一个容易被忽略的原因：你同时配置了多个仓库，而Gradle在解析依赖时会按仓库声明顺序逐个尝试，第一个仓库找不到才会去第二个。如果你把一堆镜像仓库全部堆在前面，每次解析都要在多个仓库之间轮询请求，慢反而成了必然。

我的建议是默认只保留前面说的三件套：

groovy复制maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }

够用就行，不要为了求稳把所有备选地址都堆上，仓库列表越短，Gradle做依赖解析时越果断。

6. 我实际操作后的几点体会

分享几个长期使用下来的心得，适合当作默认习惯：

第一，全局init.gradle是性价比最高的配置方式。不是每个项目都会用最新版的Android Studio模板，也可能从GitHub拉下来的是老项目，手动改每个项目太折腾，全局加一份镜像仓库，无论项目里怎么配置都能有个兜底。

第二，依赖版本尽量选已经发布一段时间的稳定版。镜像源同步是半自动的，你非要卡着刚发布的版本去用，遇到404很正常，这不算镜像的锅，但能省不少折腾时间。AGP插件版本同理，稳定大版本永远比beta版省心。

第三，改完任何配置后，强制重新同步一次再下结论。用Android Studio工具栏的同步按钮，或者直接命令行执行：

bash复制./gradlew clean assembleDebug

观察日志里的下载地址是否包含aliyun。如果日志里压根没出现任何下载链接，说明依赖全在Gradle缓存里，速度本来就不会慢；如果出现大量官方源链接，那就说明镜像配置没有被正确加载。

最后再说一个容易被忽视的点：Android Studio的SDK组件、Gradle发行版、依赖库这三类下载，互相之间没有任何依赖关系，一个加速了不代表另外两个也加速。经常有人配置完阿里云镜像后兴高采烈，结果卡在Gradle发行版下载上，还以为配置失败了。把第3章那几步也顺手做了，整个流程才算真正闭环。