Java 中怎么在 Gradle 中配置多项目（Multi-project）构建与模块依赖-java教程-PHP中文网

gradle多项目构建核心是模块“有身份、有规矩、有来往”：settings.gradle注册身份（路径严格匹配、大小写敏感、禁通配符、显式声明根名），根build.gradle定规矩（subprojects统一java环境、allprojects配仓库插件、禁直接写依赖），子模块build.gradle只选插件和声明依赖（路径一致、区分implementation/api），统一版本用libs.versions.toml。

java 中怎么在 gradle 中配置多项目（multi-project）构建与模块依赖

Java 中用 Gradle 做多项目构建，关键不是堆模块，而是让每个模块“有身份、有规矩、有来往”：身份靠 settings.gradle 注册，规矩靠根 build.gradle 统一立，来往靠 project(':xxx') 显式声明。

settings.gradle 必须写对，否则 Gradle 根本不认识你的模块

这个文件是整个多项目构建的起点，必须放在根目录，且内容要严格匹配实际文件夹结构：

用相对路径 + 冒号语法：如子模块在 auth-service/ 目录下，就写 include "auth-service"；若在 infrastructure/discovery-client/，则写 include "infrastructure:discovery-client"
大小写敏感、不能带斜杠或后缀：include "UserService"（错，文件夹叫 user-service）或 include "user-service/"（错，结尾不能有斜杠）都会导致 Project directory '...' does not exist
禁止通配符：include "services/*" 不被 Gradle 原生支持，会导致构建不稳定，必须逐个写明
根项目名建议显式声明：加上 rootProject.name = "my-platform"，避免默认名干扰发布或 IDE 识别

根 build.gradle 只管“定调子”，不写具体业务逻辑

它负责统一基础能力，所有子模块自动继承或按需复用：

Java Maven Secondary Analysis

分析ZIP压缩包或GitLab仓库中的Java Maven项目，确定二次开发范围、类数量、模块分布及生产相关指标。

下载

用 subprojects 统一 Java 环境：设置 JDK 版本、源码编码、测试框架等，例如：
subprojects { java.toolchain.languageVersion = JavaLanguageVersion.of(17) }
用 allprojects 配置全局仓库和插件：比如启用 java-library 插件、配置阿里云镜像仓库，避免每个模块重复写 repositories
不直接写依赖：根项目的 dependencies 块对子模块无效；想统一管理版本，请用 libs.versions.toml 或 Spring Boot 的 BOM

子模块 build.gradle 只做两件事：选插件、声明依赖

每个模块职责不同，配置应差异化，而不是复制粘贴：

公共模块（如 common）只加依赖，不加 Spring Boot 插件：它只是工具集合，不应启动 Web 容器
服务模块（如 order-service）才应用 org.springframework.boot:spring-boot-gradle-plugin，并声明 implementation project(":common")
依赖路径必须与 settings.gradle 里完全一致：如果 settings.gradle 写了 include "gateway"，那其他模块只能写 project(":gateway")，写成 project(":api-gateway") 就会报 Could not resolve project ':xxx'
区分 implementation 和 api：内部用 implementation；若该模块对外暴露接口（如 SDK 模块），用 api project(":core") 让上层能间接访问其依赖

统一版本管理别靠人肉改，用 libs.versions.toml

这是 Gradle 官方推荐、类型安全、IDE 支持好的方式，适合所有 Java 多模块项目：

在根目录创建 gradle/libs.versions.toml，定义版本别名和依赖坐标，例如：

[versions]<br>springs = "3.3.2"<br>[libraries]<br>spring-web = { group = "org.springframework.boot", name = "spring-boot-starter-web", version.ref = "springs" }