无需修改代码，Gradle搜索本地M2仓库的mavenLocal()替代方案

当然有！不用碰项目里的build.gradle、settings.gradle或者任何源代码，有几种全局或临时的方法能让Gradle自动搜索本地M2仓库，根据你的使用场景选就行：

1. 全局初始化脚本（长期生效，所有项目通用） #

Gradle会自动加载用户目录下的全局初始化脚本，只要在这里配置仓库，所有本地的Gradle项目都会自动应用这个设置，完全不用改项目本身的文件。

操作步骤： #

1. 找到你的Gradle用户目录：
   • Linux/macOS：~/.gradle/
   • Windows：C:\Users\<你的用户名>\.gradle\
2. 在这个目录下创建（如果没有的话）一个名为init.gradle的文件，写入以下内容：

   allprojects {
       repositories {
           // 把本地M2仓库加到仓库列表最前面，优先搜索本地
           mavenLocal()
           // 可以保留默认的远程仓库，比如mavenCentral，按需调整
           mavenCentral()
       }
   }
   

3. 保存后，任何Gradle项目构建时都会自动包含本地M2仓库的搜索逻辑。

2. 命令行参数（临时生效，单次构建用） #

如果只是偶尔需要让某个项目用本地M2仓库，不想改全局配置，直接用命令行参数就能搞定：

方式一：指定临时初始化脚本 #

先创建一个临时的脚本文件（比如local-repo.gradle），内容很简单：

allprojects {
    repositories {
        mavenLocal()
        mavenCentral()
    }
}

然后执行构建命令时带上这个脚本：

gradle build --init-script local-repo.gradle

方式二：直接通过命令行参数添加仓库 #

Gradle支持直接通过命令行参数追加仓库，更简洁：

gradle build --repository mavenLocal

这个命令会在项目原有仓库的基础上，额外添加本地M2仓库的搜索。

3. 全局Gradle属性配置（另一种全局生效方式） #

你也可以在用户目录的~/.gradle/gradle.properties文件里添加属性，结合Gradle的默认行为来启用本地仓库。不过这种方式需要确保Gradle能识别对应的属性，最稳妥的还是用初始化脚本，但如果你偏好属性配置，可以试试：
在gradle.properties里加入：

org.gradle.repositories.default=mavenLocal,mavenCentral

这个属性会让Gradle默认使用指定的仓库列表，不过注意部分旧版本Gradle可能不支持这个属性，建议优先用初始化脚本。

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