返回
创建于
状态
公开

要在 Gradle 中配置国内镜像源（如阿里云、腾讯云等），最推荐的方式是修改 全局配置，这样你所有的项目都能直接受益，不用在每个项目的 build.gradle 里重复写。

按照以下步骤操作：

1. 找到 init.gradle 文件

在你的用户目录下找 .gradle 文件夹：

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

如果该目录下没有 init.gradle 文件，请手动创建一个。

2. 写入配置内容

将以下内容复制到 init.gradle 中。这份配置涵盖了阿里云的公共仓库，可以加速 Google、Maven Central 等依赖的下载：

gradle
1allprojects {
2    repositories {
3        maven { url 'https://maven.aliyun.com/repository/public/' }
4        maven { url 'https://maven.aliyun.com/repository/google/' }
5        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
6        maven { url 'https://maven.aliyun.com/repository/jcenter/' }
7        mavenCentral()
8        google()
9    }
10}

3. 如果只想针对单个项目

如果你不想影响全局，只想在当前项目生效，请修改项目根目录下的 build.gradle（或 settings.gradle，取决于你的 Gradle 版本）：

对于较新的 Gradle 版本 (7.x / 8.x)，建议在 settings.gradle 中修改：

gradle
1pluginManagement {
2    repositories {
3        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
4        maven { url 'https://maven.aliyun.com/repository/public' }
5        gradlePluginPortal()
6    }
7}
8dependencyResolutionManagement {
9    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
10    repositories {
11        maven { url 'https://maven.aliyun.com/repository/public' }
12        maven { url 'https://maven.aliyun.com/repository/google' }
13        mavenCentral()
14        google()
15    }
16}

💡 小贴士

  • 验证是否生效：配置完成后，回到你的项目运行 ./gradlew build --info，在输出日志中你可以看到 Gradle 开始从 maven.aliyun.com 下载 jar 包。
  • 常见镜像地址：
  • 阿里云: https://maven.aliyun.com/repository/public
  • 腾讯云: https://mirrors.cloud.tencent.com/nexus/repository/maven-public/
  • 华为云: https://repo.huaweicloud.com/repository/maven/