gradle 全局镜像
时间: 2025-03-25 19:03:47 浏览: 42
### 配置 Gradle 全局镜像
为了加速依赖项的下载,可以通过配置 Gradle 的全局镜像来实现。以下是具体的配置方法:
#### 方法一:通过 `init.gradle` 文件配置
Gradle 支持使用初始化脚本 (`init.gradle`) 来完成全局配置。此文件可以放置在用户的主目录下。
1. 创建或编辑位于用户主目录下的 `.gradle/init.d/init.gradle` 文件(如果不存在则创建)。
对于 Windows 用户路径为:`C:\Users\<YourUsername>\.gradle\init.d\init.gradle`;对于 macOS/Linux 用户路径为:`~/.gradle/init.d/init.gradle`。
2. 在该文件中添加如下内容以指定阿里云镜像作为全局镜像源:
```groovy
allprojects {
repositories {
maven { url 'https://maven.aliyun.com/repository/public' } [^1]
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/central' }
maven { url 'https://maven.aliyun.com/repository/jcenter' }
maven { url 'https://maven.aliyun.com/repository/gradle-plugin' } [^2]
}
}
```
上述代码片段会覆盖默认的 Maven 中央仓库和其他可能存在的远程仓库地址。
---
#### 方法二:修改 `build.gradle` 或 `settings.gradle`
虽然这种方法不是完全意义上的“全局”配置,但它适用于特定项目范围内的调整。
可以在项目的根目录中的 `build.gradle` 或者 `settings.gradle` 文件里加入类似的仓库声明语句:
```groovy
repositories {
mavenCentral()
google() [^3]
// 添加阿里云镜像库
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' }
}
```
注意,在实际开发环境中推荐优先采用 **方法一** 实现真正的全局配置效果。
---
#### 注意事项
- 如果正在使用的 IDE 是 Android Studio,则还需要确认其内部嵌入式的 Gradle 版本是否支持所配置的内容。
- 确保网络环境允许访问目标镜像站点 (如 https://maven.aliyun.com/) ,否则即使完成了本地配置也可能无法正常拉取资源。
---
阅读全文
相关推荐

















