替换为腾讯云或阿里云等国内镜像源可显著提升Gradle依赖下载与构建速度，需在settings.gradle(.kts)中配置pluginManagement和dependencyResolutionManagement仓库，优先使用https://mirrors.cloud.tencent.com/nexus/repository/maven-public/或https://maven.aliyun.com/repository/public，并保留mavenCentral()兜底。
在 Java 项目中使用 Gradle 时，将默认的 Maven 中央仓库替换为国内镜像源（如腾讯云、阿里云）能显著提升依赖下载和构建速度，尤其在访问国外网络不稳定或受限时效果明显。
修改 gradle/wrapper/gradle-wrapper.properties（可选，仅限升级 Gradle 版本时）
该文件控制 Gradle 自身的分发包下载地址。若需加速 Gradle 下载（而非项目依赖），可将 distributionUrl 指向腾讯云或阿里云的镜像：
- 腾讯云镜像：
https://mirrors.cloud.tencent.com/gradle/gradle-8.5-bin.zip - 阿里云镜像：
https://mirrors.aliyun.com/gradle/gradle-8.5-bin.zip
注意：Gradle 版本号（如 8.5）需与你项目实际使用的版本一致，否则可能启动失败。
配置 settings.gradle(.kts) 添加镜像仓库（推荐方式）
这是最常用且推荐的方式，适用于 Gradle 6.8+（Kotlin DSL 或 Groovy DSL 均支持）。它只影响项目依赖解析，不改动 Gradle 自身分发逻辑。
立即学习“Java免费学习笔记（深入）”；
Groovy 语法（settings.gradle）：
pluginManagement {
repositories {
maven { url 'https://mirrors.cloud.tencent.com/nexus/repository/maven-public/' }
maven { url 'https://maven.aliyun.com/repository/public' }
gradlePluginPortal()
// 可选：保留中央仓库兜底
mavenCentral()
}
}
dependencyResolutionManagement {
repositories {
maven { url 'https://mirrors.cloud.tencent.com/nexus/repository/maven-public/' }
maven { url 'https://maven.aliyun.com/repository/public' }
mavenCentral()
}
}
Kotlin 语法（settings.gradle.kts）：
pluginManagement {
repositories {
maven("https://mirrors.cloud.tencent.com/nexus/repository/maven-public/")
maven("https://maven.aliyun.com/repository/public")
gradlePluginPortal()
mavenCentral()
}
}
dependencyResolutionManagement {
repositories {
maven("https://mirrors.cloud.tencent.com/nexus/repository/maven-public/")
maven("https://maven.aliyun.com/repository/public")
mavenCentral()
}
}
说明：
- 两个镜像源可同时配置，Gradle 会按顺序尝试，任一可用即成功；
- 建议把国内源放在
mavenCentral()前面，优先走镜像； - 腾讯云镜像稳定、同步及时，阿里云镜像覆盖广、响应快，两者任选其一或并用均可；
- 保留
mavenCentral()是为了兜底——某些新发布或特殊仓库的依赖可能尚未同步到镜像。
项目级配置（build.gradle(.kts)）不推荐用于全局镜像
虽然可在 build.gradle 的 repositories 块中添加镜像，但这种方式仅对当前模块生效，且无法覆盖插件仓库（pluginManagement），容易遗漏关键依赖。因此应优先统一在 settings.gradle 中配置，确保所有模块和插件都受益。
验证是否生效
执行以下命令触发依赖解析，并观察日志输出：
./gradlew build --refresh-dependencies
若看到类似 Downloading from aliyun: https://maven.aliyun.com/... 或 from tencent: https://mirrors.cloud.tencent.com/... 的日志，说明镜像已生效。也可临时注释掉镜像地址再执行一次，对比下载耗时差异。
不复杂但容易忽略，配一次就能长期提速。
