Gradle插件与依赖的私有镜像配置咨询

嗨，我来帮你搞定Gradle插件从公司私有镜像下载的配置问题～其实Gradle里插件的仓库配置和普通依赖的仓库是分开的，得两边都配置好才能确保所有内容都从私有镜像拉取，下面分两种场景给你讲：

一、项目级配置（单项目生效） #

这种方式只针对当前项目生效，适合单个项目的个性化配置。

1. 配置插件专属仓库 #

Gradle插件默认是从官方的gradlePluginPortal拉取的，我们需要把它替换成公司的私有镜像。打开项目根目录下的settings.gradle（如果是Kotlin DSL就是settings.gradle.kts），修改pluginManagement块：

Groovy语法（settings.gradle）

pluginManagement {
    repositories {
        // 先注释掉默认的官方插件仓库和Maven中央仓库
        // gradlePluginPortal()
        // mavenCentral()
        // 添加上公司私有镜像地址
        maven {
            url "https://your-company-mirror-url/repository/maven-public/"
            // 如果私有镜像需要用户名密码认证，加上这段（建议用环境变量存敏感信息）
            credentials {
                username = System.getenv("COMPANY_MAVEN_USER")
                password = System.getenv("COMPANY_MAVEN_PWD")
            }
        }
    }
}

Kotlin语法（settings.gradle.kts）

pluginManagement {
    repositories {
        // 注释默认仓库
        // gradlePluginPortal()
        // mavenCentral()
        maven {
            url = uri("https://your-company-mirror-url/repository/maven-public/")
            credentials {
                username = System.getenv("COMPANY_MAVEN_USER")
                password = System.getenv("COMPANY_MAVEN_PWD")
            }
        }
    }
}

2. 配置普通依赖仓库 #

插件可能会依赖一些第三方库，这些库的仓库也要改成私有镜像，打开项目的build.gradle（或build.gradle.kts）：

Groovy语法（build.gradle）

repositories {
    // 注释默认公共仓库
    // mavenCentral()
    maven {
        url "https://your-company-mirror-url/repository/maven-public/"
        credentials {
            username = System.getenv("COMPANY_MAVEN_USER")
            password = System.getenv("COMPANY_MAVEN_PWD")
        }
    }
}

Kotlin语法（build.gradle.kts）

repositories {
    // 注释默认公共仓库
    // mavenCentral()
    maven {
        url = uri("https://your-company-mirror-url/repository/maven-public/")
        credentials {
            username = System.getenv("COMPANY_MAVEN_USER")
            password = System.getenv("COMPANY_MAVEN_PWD")
        }
    }
}

二、全局配置（所有本地项目生效） #

如果想让你本地所有Gradle项目都默认用公司私有镜像，可以修改Gradle的全局初始化脚本，位置在用户目录下的~/.gradle/init.gradle（Groovy）或~/.gradle/init.gradle.kts（Kotlin）：

Groovy语法（init.gradle）

// 配置所有项目的依赖仓库
allprojects {
    repositories {
        maven {
            url "https://your-company-mirror-url/repository/maven-public/"
            credentials {
                username = System.getenv("COMPANY_MAVEN_USER")
                password = System.getenv("COMPANY_MAVEN_PWD")
            }
        }
    }
}

// 配置所有项目的插件仓库
settingsEvaluated { settings ->
    settings.pluginManagement {
        repositories {
            maven {
                url "https://your-company-mirror-url/repository/maven-public/"
                credentials {
                    username = System.getenv("COMPANY_MAVEN_USER")
                    password = System.getenv("COMPANY_MAVEN_PWD")
                }
            }
        }
    }
}

几个关键注意点 #

• 一定要注释掉默认的公共仓库（比如gradlePluginPortal()、mavenCentral()），否则Gradle可能会优先去公共仓库拉取内容。
• 敏感信息（比如用户名密码）别硬编码在配置文件里，用环境变量读取更安全，也方便团队统一配置。
• 如果你们公司的私有镜像已经代理了官方插件仓库和Maven中央仓库，那只需要配置这一个私有镜像地址就够了，不用再保留其他仓库。

备注：内容来源于stack exchange，提问作者Michel Samia