借助IDEA搭建Spring Boot 3工程（gradle版）

文章标题：

利用IDEA搭建Spring Boot 3项目（gradle版本）

文章内容：

小贴士：按照下述步骤创建项目能减少出错几率
本教程测试时采用的是IDEA 2022.2.3，使用其他版本的操作大致相仿
父项目名称：parent-project
后端子模块名称：server
前端子模块名称：web
可根据实际情况进行调整，比如使用别的项目名或者创建多个子模块

新建父项目

1. 选中Spring Initializr，填写项目名称（parent-project）等相关信息，需留意：Spring Boot 3最低支持的Java版本为17，点击下一步。
2. 选择子Spring Boot项目所需的依赖，如果要创建多个Spring Boot子模块，可选择其中一个子模块的依赖。例如：
   • Spring Boot DevTools
   • Lombok
   • Spring Web
   • MySQL Driver
   • MyBatis Framework
3. 点击创建按钮，等待项目创建完成。

新建Spring Boot子模块

1. 右键点击父项目（parent-project），选择新建 - 新模块。
2. 在左侧选择新建模块（注意：不要再选择Spring Initializr），填写子模块名称（server），要保证构建系统选择gradle，父项选择parent-project。
3. 打开父项目的build.gradle.kts (parent-project)文件，将其全部内容复制到子Spring Boot模块的build.gradle.kts (server)文件中。直接覆盖build.gradle.kts (server)原来的内容就行。同时父项目只需保留group和version属性即可。此时：

// build.gradle.kts (parent-project)
group = "com.example"
version = "0.0.1-SNAPSHOT"

// build.gradle.kts (server)
plugins {
    java
    id("org.springframework.boot") version "3.3.4"
    id("io.spring.dependency-management") version "1.1.6"
}

java {
    toolchain {
        languageVersion.set(JavaLanguageVersion.of(17))
    }
}

configurations {
    compileOnly {
        extendsFrom(configurations.annotationProcessor.get())
    }
}

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-web")
    implementation("org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.3")
    compileOnly("org.projectlombok:lombok")
    developmentOnly("org.springframework.boot:spring-boot-devtools")
    runtimeOnly("com.mysql:mysql-connector-j")
    annotationProcessor("org.projectlombok:lombok")
    testImplementation("org.springframework.boot:spring-boot-starter-test")
    testImplementation("org.mybatis.spring.boot:mybatis-spring-boot-starter-test:3.0.3")
    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

tasks.withType<Test> {
    useJUnitPlatform()
}

1. 重新加载所有gradle项目并重启IDEA（若代码洞察功能不可用）
2. 在Spring Boot子模块(server)的代码根目录java目录下创建Spring Boot启动类com.example.server.ServerApplication

@SpringBootApplication
public class ServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(ServerApplication.class, args);
    }
}

1. 在resources目录下创建Spring Boot配置文件application.yml

spring:
  application:
    name: server

  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    username: ${DB_USERNAME}
    password: ${DB_PASSWORD}
    url: ${DB_URL}

1. 删除父项目下的src目录，至此Spring Boot子项目创建完成

创建Vue3子项目（可选，如果需要使用gradle构建、打包node项目）

前提条件：已安装Node.js
小贴士：Windows系统建议使用nvm安装node，方便版本切换
参考链接：在 Windows 上安装 Node.js、nvm-
windows发布页面

1. 在IDEA中打开终端（或者打开系统的终端，进入到父项目所在的目录），输入npm create vue@latest来创建vue3项目（web），按照提示完成项目的创建。根据提示执行cd web、npm install来完成项目的初始化。
2. 在vue3项目所在的目录（web）创建文件build.gradle.kts，将以下内容写入其中，以此来使用gradle构建vue3项目。

import com.github.gradle.node.npm.task.NpmTask

plugins {
    id("com.github.node-gradle.node") version "7.1.0"
}

node {
    download.set(false)
}

tasks.register<NpmTask>("build") {
    group = "build"
    args.set(listOf("run", "build"))
}

1. 打开父项目的settings.gradle.kts，引入vue项目作为子模块

rootProject.name = "storage-service"
include("server", "web")

1. 重新加载所有gradle项目（刷新gradle配置），完成项目创建。
2. 检查项目是否正确创建：此时打开IDEA文件 - 项目结构 - 模块，若出现相应界面，则说明项目已正确创建。