Android Studio阿里云镜像加速配置指南，Maven学习。

原创于 2025-11-05 13:44:32 发布 · 242 阅读

3 ·

CC 4.0 BY-SA版权

在Android Studio中设置国内代理（阿里云镜像）

Android Studio开发过程中，依赖库和SDK的下载速度可能受限于网络环境。通过配置国内镜像代理（如阿里云镜像），可以显著提升下载效率，避免因网络问题导致的构建失败。

配置阿里云镜像代理

修改项目根目录下的build.gradle文件，在repositories和dependencyResolutionManagement中添加阿里云镜像源。以下为示例配置：

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

对于Gradle 7.0及以上版本，需在settings.gradle中配置：

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

配置SDK Manager代理

修改Android SDK的更新镜像源，需手动编辑SDK Manager的配置文件：

打开Android Studio的安装目录，找到android-sdk/tools/bin/sdkmanager.bat（Windows）或sdkmanager（Mac/Linux）。
在启动脚本中添加以下参数：

--proxy=http --proxy_host=mirrors.aliyun.com --proxy_port=80

或直接修改全局配置文件~/.android/androidtool.cfg，添加：

sdkman.force.http=true
sdkman.http.proxy=mirrors.aliyun.com:80

验证配置是否生效

执行Gradle同步或运行任意构建任务，观察下载源是否变更为阿里云镜像。可通过以下命令检查依赖下载路径：

./gradlew --info dependencies

输出中应包含maven.aliyun.com的URL记录。若仍有资源从境外下载，需检查是否所有repositories块均已覆盖。

常见问题解决

代理未生效

确保项目配置未覆盖全局设置，检查build.gradle和settings.gradle的优先级。
清除Gradle缓存：删除~/.gradle/caches目录后重新同步。

SSL证书错误

阿里云镜像采用HTTPS协议，若遇到证书问题，可临时启用HTTP源（不推荐）或更新JDK的根证书。

部分库无法下载

某些专有库（如Firebase）可能不在镜像中，需保留google()或mavenCentral()声明。