Gradle全局插件仓库配置失效：如何为所有项目统一配置插件仓库？

你遇到的问题其实是因为Gradle并不会自动将~/.gradle/settings.gradle作为全局配置文件应用到所有项目中——每个项目的settings.gradle是独立加载的，全局那个文件不会被默认继承。要实现全局统一配置插件仓库，正确的姿势是使用Gradle初始化脚本（Init Scripts），下面是具体步骤：

1. 创建全局初始化脚本目录 #

如果~/.gradle/init.d/目录不存在，先创建它：

mkdir -p ~/.gradle/init.d/

2. 编写全局插件仓库配置脚本 #

在~/.gradle/init.d/下新建一个脚本文件（比如命名为global-plugin-repos.gradle，文件名只要后缀是.gradle就行），内容如下：

settingsEvaluated { settings ->
    settings.pluginManagement {
        repositories {
            // 优先配置你的私有插件仓库
            maven {
                url 'https://artifactory.mycompany.org/artifactory/gradle-plugins/'
                credentials {
                    // 这里推荐用环境变量或Gradle属性存敏感信息，避免明文暴露
                    username = System.getenv('ARTIFACTORY_USER') ?: gradleProperties.getProperty('artifactory.user')
                    password = System.getenv('ARTIFACTORY_PWD') ?: gradleProperties.getProperty('artifactory.password')
                }
            }
            // 保留官方插件仓库（可选，如果你还需要从官方拉取插件的话）
            gradlePluginPortal()
        }
    }
}

3. 安全存储敏感凭证（可选但推荐） #

不要把明文密码写在脚本里，建议在~/.gradle/gradle.properties中添加凭证信息：

artifactory.user=some-user
artifactory.password=some-password

或者通过系统环境变量ARTIFACTORY_USER和ARTIFACTORY_PWD来设置，这样更安全，避免敏感信息泄露。

为什么这个方案有效？ #

Gradle会自动加载~/.gradle/init.d/目录下的所有.gradle脚本，在每个项目构建的settings阶段执行。通过settingsEvaluated钩子，我们可以在项目自身的settings.gradle被评估后，注入全局的插件仓库配置——如果项目没有自己定义pluginManagement块，全局配置会直接生效；如果项目有自己的配置，两者的仓库会合并（Gradle会按顺序优先使用前面的仓库查找插件）。

验证配置是否生效 #

随便找一个本地Gradle项目，运行gradle build --info，在日志中查找类似"Looking for plugin ... in repositories"的输出，应该能看到你的私有仓库被列入查找列表。

内容的提问来源于stack exchange，提问作者Cleankod