在Gradle Spring Boot项目中创建新子项目

Gradle没有官方内置的命令可以自动添加新子项目，需要通过手动配置完成，以下是标准的最佳实践步骤：

1. 创建子项目目录结构 #

在根项目目录下新建对应子项目的文件夹（比如命名为user-service），并按照Gradle的标准项目结构创建源码目录：

• 若为Java项目：user-service/src/main/java、user-service/src/test/java
• 若为Kotlin项目：user-service/src/main/kotlin、user-service/src/test/kotlin
  如果是简单模块，也可以先只创建核心目录，后续再补充。

2. 编写子项目的构建脚本 #

在子项目目录下创建build.gradle（Groovy DSL）或build.gradle.kts（Kotlin DSL），根据子项目类型配置插件、依赖和任务。例如，Java库类型的基础配置：

Groovy DSL示例 #

plugins {
    id 'java-library'
}

repositories {
    mavenCentral()
}

dependencies {
    // 按需添加依赖，比如API依赖或测试依赖
    api 'org.apache.commons:commons-lang3:3.14.0'
    testImplementation 'junit:junit:4.13.2'
}

Kotlin DSL示例 #

plugins {
    `java-library`
}

repositories {
    mavenCentral()
}

dependencies {
    api("org.apache.commons:commons-lang3:3.14.0")
    testImplementation("junit:junit:4.13.2")
}

3. 在根项目注册子项目 #

打开根项目的settings.gradle（或settings.gradle.kts），通过include语句注册新子项目：

• 若子项目直接在根目录下：include ':user-service'
• 若子项目在嵌套目录（比如modules/user-service）：include ':modules:user-service'
  如果子项目的物理路径和逻辑名称不一致，可额外指定目录：

// Groovy DSL
project(':modules:user-service').projectDir = file('modules/user-service')

// Kotlin DSL
project(":modules:user-service").projectDir = file("modules/user-service")

4. 验证配置 #

在根项目目录执行以下命令验证：

• gradle projects：查看输出列表中是否包含新子项目
• gradle :user-service:build：测试子项目能否正常构建

额外优化建议 #

如果多个子项目类型一致（比如都是Java库），可以在根项目的构建脚本中通过subprojects块统一配置通用项，减少重复代码：

// 根项目build.gradle
subprojects {
    apply plugin: 'java-library'
    repositories {
        mavenCentral()
    }
    tasks.withType(Test) {
        useJUnitPlatform()
    }
}

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