当前位置：首页 > news >正文

Android Studio 国内镜像使用与 SDK 下载速度优化指南

news 来源：原创 2025/4/22 6:21:45

本文适用于刚装好 Android Studio、SDK 下载缓慢、更新困难，以及 Gradle 构建缓慢的开发者。我们会讲：

如何替换国内镜像源（包括 SDK 和 Gradle）
如何解决 emulator 镜像下载失败的问题
一些终极提速技巧（比如代理配置）

一、SDK 国内镜像配置

1. 更改 `sdk-manager` 下载源

我们需要改的是 Android SDK 的 dl.google.com 下载链接。

打开你的 Android Studio 安装目录下的：

<你的安装路径>/bin/idea.properties

添加如下配置（如果没有就新建）：

disable.android.first.run=true

这个操作可以防止首次启动就自动检查 SDK 更新。然后手动配置下载源。

接着打开 tools/bin/sdkmanager，你可以指定代理或换国内镜像源来下载。我们推荐使用清华大学的镜像站。

2. 配置清华镜像（推荐）

编辑 SDK Manager 的配置：

cd ~/Android/Sdk/tools/bin
./sdkmanager --no_https --proxy=http --proxy_host=mirrors.tuna.tsinghua.edu.cn --proxy_port=80 "platform-tools"

你也可以添加一个配置文件 ~/.android/repositories.cfg：

### repositories.cfg
### 使用国内镜像，比如阿里、清华、中科大

不过更推荐直接配置 build.gradle。

二、Gradle 国内加速配置

这个不改基本就别想顺利 Sync 项目。

修改 `gradle-wrapper.properties`

打开你的项目目录下的 gradle/wrapper/gradle-wrapper.properties 文件：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-all.zip

替换为阿里镜像：

distributionUrl=https\://mirrors.aliyun.com/gradle/gradle-7.4-all.zip

修改 `build.gradle` 的 `repositories`

打开项目根目录的 build.gradle 文件，找到：

allprojects {repositories {google()mavenCentral()jcenter() // 如果有}
}

改成国内源：

allprojects {repositories {maven { url 'https://maven.aliyun.com/repository/google' }maven { url 'https://maven.aliyun.com/repository/central' }maven { url 'https://maven.aliyun.com/repository/jcenter' }}
}

别忘了把 settings.gradle 里也同步下这块。

三、Emulator 镜像下载失败？这有解！

Emulator 镜像的下载地址一般是：

https://dl.google.com/android/repository/sys-img/...

很多时候根本连不上。国内目前较好的解决方案是：

方法一：手动下载 system image

可以去清华镜像站：

👉 https://mirrors.tuna.tsinghua.edu.cn/help/android/

里面有 system-images 目录，直接找对应的版本下载，然后丢到：

<SDK路径>/system-images/

文件结构一定要对，比如 android-30/google_apis/x86/

方法二：使用代理

如果你能挂代理，直接在 Android Studio 中设置：

File -> Settings -> Appearance & Behavior -> System Settings -> HTTP Proxy

选择 Manual proxy configuration，填上你自己本地代理的端口。

四、终极技巧：使用国产 IDE 版本

如果你实在懒得折腾，还可以试试国产的 Android Studio 魔改版，比如：

GoLand-Android（JetBrains 系列魔改）
Himalaya Studio（社区版）

这些版本自带了国内镜像配置，开箱即用，不用你手动改配置。

五、总结一下

项目	原始地址	替代方案（镜像）
SDK下载	`dl.google.com`	清华、中科大、阿里、华为镜像
Gradle 下载	`services.gradle.org`	阿里镜像（mirrors.aliyun.com）
Maven依赖	`mavenCentral`, `jcenter`, `google()`	替换为阿里/清华 maven 镜像
Emulator 镜像下载	`dl.google.com/android/repository`	手动下载 + 挂代理