init.gradle中配置镜像源仅影响gradle自身依赖下载，不能加速项目implementation依赖；需在settings.gradle中通过dependencyresolutionmanagement配置仓库才生效。
Gradle init.gradle 里怎么写国内镜像源才生效
直接说结论：init.gradle 中配置镜像源**只对构建脚本解析阶段起作用，不能替代 settings.gradle 或 build.gradle 中的仓库配置**。它本质是“全局初始化脚本”，影响的是 Gradle 自身插件和依赖的下载（比如 Gradle Plugin Portal、gradle-wrapper.jar 的分发地址），而不是项目里 implementation 引用的第三方库。
常见错误现象：init.gradle 里加了阿里云镜像，但 ./gradlew build 还是卡在 Downloading https://repo1.maven.org/maven2/... —— 因为那是项目级 repositories 没改，不是 init 脚本管的范围。
-
init.gradle只能通过gradle.settingsEvaluated或gradle.beforeProject等钩子，间接修改每个项目的repositories - 真正想加速
implementation 'com.google.guava:guava:33.2.1-jre'这类依赖下载，必须在settings.gradle（推荐）或各模块build.gradle里配repositories - 如果你用的是 Gradle 8.0+，
init.gradle默认不启用，需手动加-I参数或设GRADLE_INIT_SCRIPT环境变量
在 init.gradle 中强制替换所有项目的 Maven 仓库
如果坚持要用 init.gradle 统一管理（比如公司内部 CI 环境），得监听项目创建时机，在 beforeProject 钩子里重写 repositories 块。注意：这会覆盖项目原本写的 mavenCentral() 或 jcenter()，务必留退路。
实操建议：
- 把镜像源写成函数，避免硬编码；推荐用
maven{ url 'https://maven.aliyun.com/repository/public' }，不用maven{ url 'https://maven.aliyun.com/nexus/content/groups/public/' }（后者路径已过时） - 保留原始中央仓作为 fallback：
maven { url 'https://repo.maven.apache.org/maven2'; mavenContent { releasesOnly() } } - 别动
pluginManagement.repositories—— 那是另一个独立配置块，init 脚本里要单独处理
示例片段（放在 ~/.gradle/init.gradle）：
gradle.beforeProject { project ->
project.repositories {
// 清空默认仓库（谨慎！）
clear()
// 添加阿里云镜像
maven { url 'https://maven.aliyun.com/repository/public' }
// 保留官方仓作兜底
maven { url 'https://repo.maven.apache.org/maven2' }
}
}
settings.gradle 才是改依赖镜像的正解位置
99% 的场景下，你应该改 settings.gradle，而不是折腾 init.gradle。它更可控、更透明、不依赖全局环境，且 Gradle 官方文档明确推荐。
为什么？因为 settings.gradle 是项目加载的第一环，pluginManagement 和 dependencyResolutionManagement 都在这里定义，一次配置，全项目继承。
- Gradle 7.0+ 必须用
dependencyResolutionManagement统一管理依赖仓库，否则子模块可能各自为政 - 别漏掉
plugins块的镜像 ——pluginManagement { repositories { ... } }控制的是id 'org.springframework.boot' version '3.2.5'这类插件的下载 - Android 项目要注意：
google()仓库已弃用，应换为maven { url 'https://maven.google.com' }或直接用google()（仅限旧版兼容）
简短示例（settings.gradle）：
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://repo.maven.apache.org/maven2' }
}
}
rootProject.name = "my-app"
容易被忽略的兼容性细节
镜像源不是加了就一定快，也不是所有 URL 都等价。几个关键点常被跳过：
- 阿里云镜像的
/repository/public和/nexus/content/groups/public/返回内容不完全一致，后者缺失部分元数据，会导致Could not resolve org.jetbrains.kotlin:kotlin-stdlib-jdk8 - 腾讯云镜像（
https://mirrors.cloud.tencent.com/nexus/repository/maven-public）不支持 HTTPS 重定向，某些 Gradle 版本会因证书链失败静默降级 - 华为云镜像（
https://repo.huaweicloud.com/repository/maven/）要求 User-Agent，老版本 Gradle（403 Forbidden - 如果你用
gradle --no-daemon调试，init 脚本里的日志不会自动输出，得加logger.lifecycle("repo set")才能看到是否执行成功
真要验证是否生效，别只看下载速度，运行 ./gradlew build --info | grep "Downloading"，确认 URL 里出现的是你配的镜像域名，而不是 repo1.maven.org。
