首先配置settings.gradle注册模块，再通过根项目build.gradle统一管理公共配置，子模块按需添加特定依赖，实现模块化构建与复用。
搭建Gradle多模块项目是Java开发中常见的需求，尤其适用于大型系统拆分、服务解耦或公共组件复用的场景。通过合理配置，可以实现模块间的依赖管理、独立编译与统一构建。以下是快速配置Gradle多模块Java项目的实用方法。
创建项目结构
首先建立标准的多模块目录结构。假设项目名为myapp，包含一个父项目和两个子模块：common（通用工具）和service（业务逻辑）。
目录结构如下：
myapp/ ├── build.gradle ├── settings.gradle ├── common/ │ └── src/main/java/ ├── service/ │ └── src/main/java/
进入myapp根目录，初始化基础文件。
立即学习“Java免费学习笔记（深入）”；
配置settings.gradle
该文件用于注册所有参与构建的模块。在根目录下创建settings.gradle，内容如下：
rootProject.name = 'myapp' include 'common' include 'service'
这样Gradle就知道要加载common和service两个子模块。
编写根项目的build.gradle
根项目的build.gradle用于定义公共配置，避免重复。示例如下：
subprojects {
apply plugin: 'java'
apply plugin: 'idea'
java {
sourceCompatibility = JavaVersion.VERSION_11
targetCompatibility = JavaVersion.VERSION_11
}
repositories {
mavenCentral()
}
dependencies {
testImplementation 'junit:junit:4.13.2'
}
}
上述配置对所有子模块生效，统一了Java版本、仓库源和测试依赖。
子模块独立配置
每个子模块可有自己的build.gradle来添加特定依赖。例如，在service模块中使用common：
dependencies {
implementation project(':common')
}
这样service就能访问common中的类。如果common需引入第三方库，可在其build.gradle中添加：
dependencies {
implementation 'org.apache.commons:commons-lang3:3.12.0'
}
验证与构建
在根目录执行以下命令验证配置是否正确：
- gradle projects：查看模块结构
- gradle tasks：列出可用任务
- gradle build：编译并运行测试
若无报错，说明多模块环境已成功搭建。
基本上就这些。Gradle多模块的核心在于settings.gradle的模块注册和根项目对子项目的统一管理。只要结构清晰、依赖明确，维护起来非常方便。
