首页 > 文章 > java教程

Java搭建Gradle多模块项目教程

时间：2026-01-06 19:03:39 363浏览收藏

一分耕耘，一分收获！既然都打开这篇《Java如何搭建Gradle多模块项目环境》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

答案：搭建Java的Gradle多模块项目需创建根目录及子模块，配置settings.gradle注册模块，编写各模块build.gradle定义依赖，在根build.gradle中统一管理公共配置，最后执行gradle build验证编译。

在Java中如何搭建Gradle多模块项目开发环境_JavaGradle项目环境快速配置方法

搭建Java的Gradle多模块项目，核心在于合理组织项目结构并正确配置settings.gradle和各模块的build.gradle文件。只要配置清晰，开发环境可以快速跑起来。

初始化项目结构

创建根项目目录，并在其中建立多个子模块目录。典型的结构如下：

my-project/
├── build.gradle
├── settings.gradle
├── common/
│ └── build.gradle
├── service/
│ └── build.populate.gradle
└── web/
└── build.gradle

进入根目录，运行gradle init初始化基础Gradle脚本，选择“空项目”即可。

配置settings.gradle注册模块

在根项目的settings.gradle中声明所有子模块，让Gradle识别它们为同一项目的一部分。

include 'common'
include 'service'
include 'web'

也可以使用更简洁的写法：

rootProject.name = 'my-project'
include 'common', 'service', 'web'

编写各模块的build.gradle

每个子模块需要独立的build.gradle来定义依赖和任务。

common模块：存放工具类、实体等共享代码

plugins {
id 'java'
}

group = 'com.example'
version = '1.0'

repositories {
mavenCentral()
}

dependencies {
implementation 'org.apache.commons:commons-lang3:3.12.0'
}

service模块：依赖common，实现业务逻辑

dependencies {
implementation project(':common')
}

web模块：构建Spring Boot应用，依赖service

plugins {
id 'org.springframework.boot' version '3.1.0'
id 'io.spring.dependency-management' version '1.1.0'
}

dependencies {
implementation project(':service')
implementation 'org.springframework.boot:spring-boot-starter-web'
}

统一管理依赖与插件（可选但推荐）

在根项目的build.gradle中集中管理公共配置，避免重复。

subprojects {
apply plugin: 'java'

java {
sourceCompatibility = JavaVersion.VERSION_17
}

repositories {
mavenCentral()
}

tasks.withType(JavaCompile) {
options.encoding = 'UTF-8'
}
}

这样所有子模块自动继承编码、JDK版本和仓库设置。

基本上就这些。执行gradle build验证整个项目能否编译通过。IDE导入时选择根目录的build.gradle，IntelliJ或VS Code都能自动识别多模块结构。不复杂但容易忽略的是模块间的依赖顺序和settings.gradle的包含声明。配置对了，后续开发就很顺畅。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~

前往漫画官网入口并下载 ➜