Gradle国内镜像配置教程：init.gradle、repositories与Wrappe...

沉迷在 - Java.li - 无法自拔

HiF · 2026-05-13 · via 沉迷在 - Java.li - 无法自拔

Gradle下载慢怎么办？本文整理Gradle国内镜像配置方法，包括阿里云、腾讯云、华为云镜像，settings.gradle、init.gradle、repositories、pluginManagement、gradle-wrapper.properties配置，以及IDEA和Android Studio常见报错解决。

最后更新：2026-05-13
适用系统：Windows / macOS / Linux
适用场景：Gradle 下载慢、Gradle 构建卡住、依赖下载失败、插件下载失败、Android Studio / IDEA 同步 Gradle 很慢

如果你还没有配置 JDK，可以先看：各版本JDK镜像下载地址：JDK8 / 11 / 17 / 21 / 25 / 26 下载与IDEA配置指南。

如果你使用的是 Maven 项目，可以看：Maven国内镜像settings.xml配置大全：阿里云、腾讯云、华为云、清华源。

在国内使用 Gradle，经常会遇到下面这些问题：

Downloading Gradle distribution...
Could not resolve all files for configuration
Plugin was not found in any of the following sources
Could not GET https://plugins.gradle.org/
Could not GET https://repo.maven.apache.org/maven2/
Read timed out
Connection timed out

很多人第一反应是“Gradle 又抽风了”，其实大多数时候不是 Gradle 本身的问题，而是网络访问国外仓库不稳定。

Gradle 的下载慢主要分三类：

慢在哪里	典型现象	应该改哪里
Gradle 本体下载慢	卡在 `Downloading Gradle distribution`	改 `gradle-wrapper.properties`
项目依赖下载慢	Maven Central 依赖下载失败	改 `repositories`
Gradle 插件下载慢	插件找不到或下载失败	改 `pluginManagement`

所以，Gradle 国内镜像不能只改一个地方。正确做法是：

1. Gradle Wrapper 下载地址加速
2. 项目依赖仓库 repositories 加速
3. Gradle 插件仓库 pluginManagement 加速
4. 必要时配置全局 init.gradle

本文整理阿里云、腾讯云、华为云等常用 Gradle 国内镜像配置方式，并提供 Groovy DSL、Kotlin DSL、init.gradle、Android 项目、IDEA 配置和常见报错解决方法。

一、先说结论：Gradle国内镜像怎么配最稳？

普通 Java / Spring Boot / Kotlin 项目，推荐优先改：

settings.gradle
或
settings.gradle.kts

也就是项目级配置。

如果你只是个人电脑想让所有 Gradle 项目都走国内镜像，可以改：

~/.gradle/init.gradle

如果是卡在 Gradle 本体下载，也就是一直显示：

Downloading https://services.gradle.org/distributions/gradle-xxx-bin.zip

那就改：

gradle/wrapper/gradle-wrapper.properties

不要一上来就全局乱改。推荐顺序是：

新项目：优先 settings.gradle / settings.gradle.kts
老项目：可以先改 build.gradle
个人开发机：可以加 ~/.gradle/init.gradle
CI/CD：建议用公司 Nexus / Artifactory / 私服统一代理
Gradle本体下载慢：改 gradle-wrapper.properties

二、Gradle和Maven镜像配置有什么区别？

Maven 通常改的是：

~/.m2/settings.xml

通过：

<mirrorOf>*</mirrorOf>

统一把仓库请求转到国内镜像。

但 Gradle 不完全一样。Gradle 当前没有 Maven 那种开箱即用的统一 mirror 机制，所以需要分别配置：

pluginManagement：控制 Gradle 插件从哪里下载
dependencyResolutionManagement / repositories：控制项目依赖从哪里下载
gradle-wrapper.properties：控制 Gradle 本体从哪里下载
init.gradle：控制全局默认配置

这也是很多人配置了 repositories 以后，插件还是下载失败的原因。

因为：

repositories 管项目依赖
pluginManagement 管 Gradle 插件
distributionUrl 管 Gradle 自身下载

这三个不是一回事。

三、常用Gradle国内镜像地址汇总

镜像源	主要用途	地址
阿里云 Maven 公共仓库	Java / Kotlin 普通依赖	`https://maven.aliyun.com/repository/public`
阿里云 Central 仓库	Maven Central 依赖	`https://maven.aliyun.com/repository/central`
阿里云 Google 仓库	Android 依赖	`https://maven.aliyun.com/repository/google`
阿里云 Gradle Plugin 仓库	Gradle 插件	`https://maven.aliyun.com/repository/gradle-plugin`
阿里云 Gradle 分发包	下载 Gradle 本体	`https://mirrors.aliyun.com/gradle/distributions/`
腾讯云 Maven 仓库	腾讯云环境、普通依赖	`https://mirrors.cloud.tencent.com/nexus/repository/maven-public/`
腾讯云 Gradle 分发包	下载 Gradle 本体	`https://mirrors.cloud.tencent.com/gradle/`
华为云 Maven 仓库	华为云、鲲鹏、国产化环境	`https://repo.huaweicloud.com/repository/maven/`

普通开发者建议优先用阿里云。腾讯云服务器优先用腾讯云。华为云、鲲鹏、国产化环境优先看华为云。

四、推荐配置一：settings.gradle 项目级配置

这是现在比较推荐的方式，适合 Gradle 7+、Gradle 8+、Gradle 9+ 项目。

1. Groovy DSL：settings.gradle

如果你的项目根目录下是：

settings.gradle

可以这样配置：

pluginManagement {
    repositories {
        // Gradle 插件优先走阿里云
        maven { url = uri('https://maven.aliyun.com/repository/gradle-plugin') }
        maven { url = uri('https://maven.aliyun.com/repository/public') }

        // 保留官方插件仓库兜底
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)

    repositories {
        mavenLocal()

        // 普通 Java / Kotlin 依赖
        maven { url = uri('https://maven.aliyun.com/repository/public') }

        // Maven Central 国内代理
        maven { url = uri('https://maven.aliyun.com/repository/central') }

        // Android 项目需要
        maven { url = uri('https://maven.aliyun.com/repository/google') }

        // 官方仓库兜底
        mavenCentral()
        google()
    }
}

rootProject.name = 'demo'

注意：如果你不是 Android 项目，可以删除：

google()
maven { url = uri('https://maven.aliyun.com/repository/google') }

2. Kotlin DSL：settings.gradle.kts

如果你的项目根目录下是：

settings.gradle.kts

可以这样配置：

pluginManagement {
    repositories {
        // Gradle 插件优先走阿里云
        maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
        maven { url = uri("https://maven.aliyun.com/repository/public") }

        // 保留官方插件仓库兜底
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)

    repositories {
        mavenLocal()

        // 普通 Java / Kotlin 依赖
        maven { url = uri("https://maven.aliyun.com/repository/public") }

        // Maven Central 国内代理
        maven { url = uri("https://maven.aliyun.com/repository/central") }

        // Android 项目需要
        maven { url = uri("https://maven.aliyun.com/repository/google") }

        // 官方仓库兜底
        mavenCentral()
        google()
    }
}

rootProject.name = "demo"

如果你是普通 Java 项目，也可以简化成：

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

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)

    repositories {
        mavenLocal()
        maven { url = uri("https://maven.aliyun.com/repository/public") }
        mavenCentral()
    }
}

五、repositoriesMode 报错怎么办？

有些老项目配置后会报：

Build was configured to prefer settings repositories over project repositories 
but repository 'maven' was added by build file

这是因为你在 settings.gradle 里写了：

repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)

它的意思是：不允许子项目在 build.gradle 里再声明仓库。

新项目建议这样做，因为团队仓库更统一。但老项目可能已经在多个模块里写了 repositories，这时可以临时改成：

repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)

或者：

repositoriesMode.set(RepositoriesMode.PREFER_PROJECT)

三种模式简单理解：

模式	含义	适合场景
`FAIL_ON_PROJECT_REPOS`	子项目声明仓库就报错	新项目、团队统一仓库
`PREFER_SETTINGS`	优先使用 settings 中的仓库	想统一仓库但不想立刻报错
`PREFER_PROJECT`	优先使用项目自己的仓库	老项目、迁移期

我的建议：

新项目：FAIL_ON_PROJECT_REPOS
老项目：先用 PREFER_SETTINGS
历史包袱很重的项目：短期用 PREFER_PROJECT，后面再统一迁移

六、推荐配置二：build.gradle 项目级配置

如果你的项目比较老，没有 dependencyResolutionManagement，可以直接改根目录的：

build.gradle

1. 普通 Java 项目

plugins {
    id 'java'
}

repositories {
    mavenLocal()
    maven { url 'https://maven.aliyun.com/repository/public' }
    maven { url 'https://maven.aliyun.com/repository/central' }
    mavenCentral()
}

dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter:5.10.2'
}

多模块项目可以写：

allprojects {
    repositories {
        mavenLocal()
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/central' }
        mavenCentral()
    }
}

2. 老 Android 项目

老 Android 项目经常有：

buildscript {
    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:8.5.0'
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

可以改成：

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

        google()
        mavenCentral()
        gradlePluginPortal()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:8.5.0'
    }
}

allprojects {
    repositories {
        mavenLocal()

        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/central' }

        google()
        mavenCentral()
    }
}

注意：Android 新项目更推荐把仓库写到 settings.gradle 的 pluginManagement 和 dependencyResolutionManagement 里，不建议长期使用 allprojects 管仓库。

七、推荐配置三：全局 init.gradle 配置

如果你希望所有 Gradle 项目默认都走国内镜像，可以配置：

~/.gradle/init.gradle

Windows 路径通常是：

C:\Users\你的用户名\.gradle\init.gradle

macOS / Linux 路径通常是：

~/.gradle/init.gradle

如果没有这个文件，手动创建即可。

1. Gradle 7+ 推荐 init.gradle

import org.gradle.api.initialization.resolve.RepositoriesMode

settingsEvaluated { settings ->
    settings.pluginManagement {
        repositories {
            maven { url = uri('https://maven.aliyun.com/repository/gradle-plugin') }
            maven { url = uri('https://maven.aliyun.com/repository/public') }
            gradlePluginPortal()
        }
    }

    settings.dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)

        repositories {
            mavenLocal()
            maven { url = uri('https://maven.aliyun.com/repository/public') }
            maven { url = uri('https://maven.aliyun.com/repository/central') }
            maven { url = uri('https://maven.aliyun.com/repository/google') }
            mavenCentral()
            google()
        }
    }
}

allprojects {
    repositories {
        mavenLocal()
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/central' }
        mavenCentral()
    }
}

这个配置适合个人开发机，但不建议公司团队完全依赖每个人自己的 init.gradle。

原因是：

1. 不同成员的全局配置可能不一样
2. CI/CD 环境可能没有这个文件
3. 项目换机器后可能复现不了问题
4. 依赖来源不清晰，不利于排查

团队项目更建议把仓库配置写到项目的 settings.gradle 中，或者统一走公司私服。

2. 旧版本 Gradle init.gradle

如果你的 Gradle 版本较老，不支持 dependencyResolutionManagement，可以用简化版：

allprojects {
    repositories {
        mavenLocal()
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/central' }
        maven { url 'https://maven.aliyun.com/repository/google' }
        mavenCentral()
        google()
    }
}

这种配置主要解决项目依赖下载慢，不一定能解决 Gradle 插件下载慢。

八、Gradle Wrapper 下载慢怎么办？

很多项目第一次打开时会卡在：

Downloading https://services.gradle.org/distributions/gradle-8.x-bin.zip

这是在下载 Gradle 本体，不是下载项目依赖。

对应文件是：

gradle/wrapper/gradle-wrapper.properties

原始配置可能是：

distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.5-bin.zip

可以改成阿里云镜像：

distributionUrl=https\://mirrors.aliyun.com/gradle/distributions/gradle-8.14.5-bin.zip

也可以改成腾讯云镜像：

distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.14.5-bin.zip

注意：不要随便改版本号。

比如原来是：

gradle-8.14.5-bin.zip

你只应该替换前面的域名和路径，不要顺手改成：

gradle-9.5.1-bin.zip

因为 Gradle 版本和 Android Gradle Plugin、Spring Boot 插件、Kotlin 插件可能存在兼容性要求。随便升级 Gradle，可能会引入新的构建问题。

九、bin 和 all 应该选哪个？

Gradle 分发包常见有两种：

gradle-xxx-bin.zip
gradle-xxx-all.zip

区别：

类型	内容	适合场景
`bin`	只包含运行 Gradle 所需文件	CI/CD、普通构建、体积小
`all`	包含源码和文档	IDEA / Android Studio 中查看源码、代码提示更完整

普通项目用：

gradle-xxx-bin.zip

开发机想要更好的 IDE 体验，可以用：

gradle-xxx-all.zip

例如：

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

十、腾讯云 Gradle / Maven 镜像配置

如果你的项目在腾讯云服务器、腾讯云 CODING、腾讯云 CI/CD 环境里构建，可以使用腾讯云 Maven 镜像。

1. settings.gradle 配置

pluginManagement {
    repositories {
        maven { url = uri('https://mirrors.cloud.tencent.com/nexus/repository/maven-public/') }
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)

    repositories {
        mavenLocal()
        maven { url = uri('https://mirrors.cloud.tencent.com/nexus/repository/maven-public/') }
        mavenCentral()
    }
}

2. build.gradle 配置

repositories {
    mavenLocal()
    maven { url 'https://mirrors.cloud.tencent.com/nexus/repository/maven-public/' }
    mavenCentral()
}

如果 HTTPS 访问不稳定，也可以参考腾讯云公开文档里的 HTTP 地址：

http://mirrors.cloud.tencent.com/nexus/repository/maven-public/

腾讯云服务器内网环境也可以按腾讯云文档切换内网镜像地址。

十一、华为云 Gradle / Maven 镜像配置

如果项目部署在华为云、鲲鹏服务器、国产化环境，可以使用华为云 Maven 镜像。

1. settings.gradle 配置

pluginManagement {
    repositories {
        maven { url = uri('https://repo.huaweicloud.com/repository/maven/') }
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)

    repositories {
        mavenLocal()
        maven { url = uri('https://repo.huaweicloud.com/repository/maven/') }
        mavenCentral()
    }
}

2. build.gradle 配置

repositories {
    mavenLocal()
    maven { url 'https://repo.huaweicloud.com/repository/maven/' }
    mavenCentral()
}

华为云环境中还可以配合华为云 Maven 加速地址下载 Maven 本体：

https://repo.huaweicloud.com/apache/maven/maven-3/

如果项目还涉及 JDK 下载，可以配合华为 JDK 镜像或毕昇 JDK 使用。

十二、IDEA / Android Studio 中怎么配置 Gradle？

在 IntelliJ IDEA 或 Android Studio 中，进入：

Settings > Build, Execution, Deployment > Build Tools > Gradle

macOS 是：

IntelliJ IDEA > Settings > Build, Execution, Deployment > Build Tools > Gradle

重点检查下面几个地方：

Gradle user home
Use Gradle from
Gradle JVM

推荐配置：

Use Gradle from：
优先选择 Gradle Wrapper

Gradle JVM：
选择项目要求的 JDK，例如 JDK17、JDK21

Gradle user home：
默认 ~/.gradle 即可

如果 IDEA 一直卡在 Gradle 同步，可以按顺序排查：

1. gradle-wrapper.properties 里的 distributionUrl 是否能访问
2. settings.gradle 里是否配置了 pluginManagement
3. dependencyResolutionManagement 是否配置了国内镜像
4. Gradle JVM 是否和项目要求一致
5. 是否开启了 Offline mode
6. ~/.gradle/caches 是否存在损坏缓存

十三、如何验证 Gradle 镜像是否生效？

1. 查看 Gradle 版本

Linux / macOS：

./gradlew --version

Windows：

gradlew.bat --version

如果输出了 Gradle 版本、JVM 版本、Groovy / Kotlin 版本，说明 Gradle 本体可以正常运行。

2. 刷新依赖

./gradlew clean build --refresh-dependencies

--refresh-dependencies 会让 Gradle 重新检查远程依赖，适合排查缓存问题。

3. 查看依赖树

./gradlew dependencies

也可以查看指定模块：

./gradlew :app:dependencies

4. 打印更多日志

./gradlew build --info

或者：

./gradlew build --debug

如果你想看 Gradle 到底访问了哪个仓库，--info 通常已经够用。

十四、常见报错解决

1. Plugin was not found in any of the following sources

常见原因：

只配置了 repositories，没有配置 pluginManagement
插件版本写错
国内镜像没有同步该插件
Gradle Plugin Portal 访问失败

解决方法：

1. 在 settings.gradle 中配置 pluginManagement
2. 添加阿里云 gradle-plugin 仓库
3. 保留 gradlePluginPortal() 作为兜底
4. 检查插件版本是否存在

示例：

pluginManagement {
    repositories {
        maven { url = uri('https://maven.aliyun.com/repository/gradle-plugin') }
        maven { url = uri('https://maven.aliyun.com/repository/public') }
        gradlePluginPortal()
    }
}

2. Could not resolve all files for configuration

常见原因：

项目依赖仓库没配置
依赖版本不存在
镜像源没有同步
公司网络代理限制
本地缓存损坏

解决方法：

./gradlew clean build --refresh-dependencies

如果还不行，检查：

1. dependencyResolutionManagement 是否配置
2. repositories 里是否有国内镜像
3. 依赖坐标 groupId / artifactId / version 是否正确
4. 是否需要添加 JitPack、Spring Milestone 等特殊仓库

3. Could not install Gradle distribution from ...

常见原因：

Gradle Wrapper 下载地址无法访问
distributionUrl 写错
Gradle 版本不存在
代理或证书问题

解决方法：

1. 打开 gradle/wrapper/gradle-wrapper.properties
2. 检查 distributionUrl
3. 换成阿里云或腾讯云 Gradle 分发包地址
4. 保持版本号不变

例如：

distributionUrl=https\://mirrors.aliyun.com/gradle/distributions/gradle-8.14.5-bin.zip

4. PKIX path building failed

这是 SSL 证书问题，常见于公司内网、代理网关、抓包网关环境。

常见原因：

公司 HTTPS 代理替换了证书
JDK 证书库缺少公司根证书
使用了过旧 JDK
镜像站证书链异常

解决方向：

1. 换网络测试
2. 升级 JDK
3. 让运维提供公司根证书
4. 将根证书导入 JDK cacerts
5. 检查 IDEA 和命令行使用的 JDK 是否一致

5. IDEA 能构建，命令行不能构建

常见原因：

IDEA 使用的 Gradle JVM 和命令行 JAVA_HOME 不一致
IDEA 使用 Gradle Wrapper，命令行使用本机 gradle
IDEA 配置了代理，命令行没有代理
IDEA 和命令行的 GRADLE_USER_HOME 不一样

排查命令：

java -version
./gradlew --version
gradle --version

重点看：

JVM 版本是否一致
Gradle 版本是否一致
Gradle user home 是否一致

6. 命令行能构建，IDEA 不能同步

优先检查 IDEA 的 Gradle 配置：

Settings > Build, Execution, Deployment > Build Tools > Gradle

重点看：

Use Gradle from 是否选择 Wrapper
Gradle JVM 是否正确
Offline mode 是否开启
Gradle user home 是否正确

然后点击：

Reload All Gradle Projects

十五、企业项目更建议使用公司私服

如果是公司项目，不建议每个人都直接连阿里云、腾讯云或华为云。

更推荐的方式是：

开发者 / CI
    ↓
公司 Nexus / Artifactory
    ↓
阿里云 / 腾讯云 / 华为云 / Maven Central / Gradle Plugin Portal

好处：

1. 外部依赖统一缓存
2. 构建速度更稳定
3. 公司内部依赖可以统一发布
4. 能控制依赖来源，降低供应链风险
5. CI/CD 不依赖个人电脑配置
6. 新人入职配置更简单

企业项目推荐在 settings.gradle 中统一写公司私服：

pluginManagement {
    repositories {
        maven { url = uri('https://nexus.example.com/repository/gradle-plugins/') }
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)

    repositories {
        maven { url = uri('https://nexus.example.com/repository/maven-public/') }
    }
}

如果私服需要账号密码，不建议把密码写死在项目文件里，可以放到：

~/.gradle/gradle.properties

示例：

nexusUsername=your_username
nexusPassword=your_token

然后在 Gradle 中读取：

maven {
    url = uri('https://nexus.example.com/repository/maven-public/')
    credentials {
        username = findProperty('nexusUsername')
        password = findProperty('nexusPassword')
    }
}

十六、最终推荐配置

如果你只是普通 Java 开发者，想快速解决 Gradle 下载慢，可以直接用这一份。

settings.gradle

pluginManagement {
    repositories {
        maven { url = uri('https://maven.aliyun.com/repository/gradle-plugin') }
        maven { url = uri('https://maven.aliyun.com/repository/public') }
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)

    repositories {
        mavenLocal()
        maven { url = uri('https://maven.aliyun.com/repository/public') }
        maven { url = uri('https://maven.aliyun.com/repository/central') }
        mavenCentral()
    }
}

rootProject.name = 'demo'

gradle-wrapper.properties

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://mirrors.aliyun.com/gradle/distributions/gradle-8.14.5-bin.zip
networkTimeout=10000
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

注意：上面的 gradle-8.14.5-bin.zip 只是示例。实际使用时，请改成你项目原本的 Gradle 版本，不要盲目升级。

十七、我的建议

Gradle 国内镜像配置不要只复制一段 repositories 就完事。你要先判断慢在哪里：

卡在下载 Gradle：改 gradle-wrapper.properties
依赖下载慢：改 repositories / dependencyResolutionManagement
插件下载慢：改 pluginManagement
所有项目都慢：加 ~/.gradle/init.gradle
团队项目慢：上公司 Nexus / Artifactory

个人开发环境可以使用阿里云、腾讯云、华为云镜像加速。公司项目最好统一私服，否则每个人本地配置不同，迟早会遇到“我这里能跑，你那里不能跑”的问题。

更新记录

2026-05-13：
- 增加 Gradle Wrapper 国内镜像配置
- 增加 settings.gradle / settings.gradle.kts 项目级配置
- 增加 init.gradle 全局配置
- 增加 pluginManagement 插件仓库配置
- 增加 dependencyResolutionManagement 依赖仓库配置
- 增加阿里云、腾讯云、华为云镜像地址
- 增加 IDEA / Android Studio Gradle 配置方法
- 增加 Gradle 常见报错解决方法

此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。原文来自 — 版权归原作者所有。

推荐订阅源

沉迷在 - Java.li - 无法自拔

一、先说结论：Gradle国内镜像怎么配最稳？

二、Gradle和Maven镜像配置有什么区别？

三、常用Gradle国内镜像地址汇总

四、推荐配置一：settings.gradle 项目级配置

1. Groovy DSL：settings.gradle

2. Kotlin DSL：settings.gradle.kts

五、repositoriesMode 报错怎么办？

六、推荐配置二：build.gradle 项目级配置

1. 普通 Java 项目

2. 老 Android 项目

七、推荐配置三：全局 init.gradle 配置

1. Gradle 7+ 推荐 init.gradle

2. 旧版本 Gradle init.gradle

八、Gradle Wrapper 下载慢怎么办？

九、bin 和 all 应该选哪个？

十、腾讯云 Gradle / Maven 镜像配置

1. settings.gradle 配置

2. build.gradle 配置

十一、华为云 Gradle / Maven 镜像配置

1. settings.gradle 配置

2. build.gradle 配置

十二、IDEA / Android Studio 中怎么配置 Gradle？

十三、如何验证 Gradle 镜像是否生效？

1. 查看 Gradle 版本

2. 刷新依赖

3. 查看依赖树

4. 打印更多日志

十四、常见报错解决

1. Plugin was not found in any of the following sources

2. Could not resolve all files for configuration

3. Could not install Gradle distribution from ...

4. PKIX path building failed

5. IDEA 能构建，命令行不能构建

6. 命令行能构建，IDEA 不能同步

十五、企业项目更建议使用公司私服

十六、最终推荐配置

settings.gradle

gradle-wrapper.properties

十七、我的建议

更新记录