多模块Gradle项目如何在父目录声明公共依赖并成功编译？

嘿，这问题我太熟了！之前刚踩过类似的坑——直接在父项目的build.gradle里写dependencies根本没用，因为那只会把依赖加到父项目本身，子模块根本继承不到。得用Gradle的子项目配置块来搞，给你说两种常用的方法：

方法一：用subprojects直接注入依赖 #

这是最直接的方式，适合简单的多模块项目。把所有子模块共用的配置（插件、仓库、依赖）都包在subprojects块里，Gradle会自动把这些配置应用到每个子模块上。

举个实际的例子，父项目的build.gradle可以这么写：

// 针对所有子模块生效的配置
subprojects {
    // 先给子模块应用Java插件（如果你的模块是Java项目，必须加这个！不然implementation这些依赖配置会报错）
    plugins {
        id 'java'
    }

    // 配置子模块的仓库，比如用Maven中央仓库
    repositories {
        mavenCentral()
        // 可以加国内镜像加速，比如阿里云：
        // maven { url 'https://maven.aliyun.com/repository/public' }
    }

    // 这里写所有子模块共用的公共依赖
    dependencies {
        // 比如常用的JUnit5测试依赖
        implementation 'org.junit.jupiter:junit-jupiter-api:5.9.2'
        testImplementation 'org.junit.jupiter:junit-jupiter-engine:5.9.2'
        // 再比如工具类库Guava
        implementation 'com.google.guava:guava:32.1.3-jre'
    }
}

为什么之前失败？ #

大概率是你没把依赖放在subprojects里，而是直接在父项目根级的dependencies块里写了，那只会给父项目本身加依赖，和子模块完全没关系。另外如果子模块没应用Java插件，implementation这种依赖配置项根本不存在，也会导致编译报错。

方法二：用dependencyManagement统一管理版本（进阶版） #

如果你的项目依赖很多，而且需要统一控制版本号，避免子模块版本冲突，推荐用dependencyManagement插件。它的作用是统一声明依赖版本，子模块只需要写依赖的组和名称，不用写版本号，自动继承父项目的版本配置。

父项目build.gradle示例：

// 先在父项目应用dependencyManagement插件
plugins {
    id 'java'
    id 'io.spring.dependency-management' version '1.1.3'
}

// 统一管理所有依赖的版本
dependencyManagement {
    dependencies {
        // 声明每个依赖的版本
        dependency 'org.junit.jupiter:junit-jupiter-api:5.9.2'
        dependency 'org.junit.jupiter:junit-jupiter-engine:5.9.2'
        dependency 'com.google.guava:guava:32.1.3-jre'
        // 也可以引入BOM来批量管理版本，比如Spring Boot的BOM
        // imports { mavenBom 'org.springframework.boot:spring-boot-dependencies:3.2.0' }
    }
}

// 给子模块应用插件和基础配置
subprojects {
    apply plugin: 'java'
    apply plugin: 'io.spring.dependency-management'

    repositories {
        mavenCentral()
    }

    // 子模块里只需要写依赖的组和名，版本由父项目的dependencyManagement控制
    dependencies {
        implementation 'org.junit.jupiter:junit-jupiter-api'
        testImplementation 'org.junit.jupiter:junit-jupiter-engine'
        implementation 'com.google.guava:guava'
    }
}

额外注意点 #

• 如果你的子模块类型不一样（比如一个是Java，一个是Android），可以通过项目名称来区分配置：

  subprojects {
      if (project.name == 'module1') {
          apply plugin: 'java'
          // 给module1单独加依赖
      } else if (project.name == 'module2') {
          apply plugin: 'com.android.application'
          // 给module2加Android相关配置
      }
  }
  

• 子模块里可以单独添加自己的私有依赖，不会和父项目的公共依赖冲突，Gradle会自动合并所有依赖。

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