苍穹外卖是如何从0搭建一个标准的 Maven 多模块项目的?

核心概念理解

首先,理解两个关键概念:

  1. ​父项目/聚合模块​ ​:就是你图片中最顶层的项目(sky-take-out),它本身的 pom.xml主要功能是​​管理​​:声明它包含了哪些子模块,并统一管理所有子模块的公共依赖和插件版本。

  2. ​子模块​ ​:就是 sky-common, sky-pojo, sky-server这些具体的功能模块。它们有自己独立的 pom.xml,继承父项目的配置,并声明自己特有的依赖。

太棒了!从你提供的图片可以清晰地看出,​​"苍穹外卖"项目是一个标准的 Maven 多模块项目​​。这种结构非常适合像你们这样分工明确的中大型项目,因为它可以实现代码的复用、模块化管理和依赖清晰化。

下面我为你详细讲解如何在 IntelliJ IDEA 中从头创建这样一个多模块项目,并解释其核心思想。


🛠️ 一步步创建多模块项目

第一步:创建父项目(聚合项目)

父项目本身通常不写业务代码,它只是一个"容器"。

  1. ​新建项目​ ​:打开 IDEA,选择 File-> New-> Project...

  2. ​选择Maven​ ​:在左侧选择 Maven。不要勾选 Create from archetype(我们从零开始创建)。直接点击 Next

  3. ​填写坐标​​:

    • ​GroupId​ ​: com.sky(根据项目实际修改)

    • ​ArtifactId​ ​: sky-take-out(这是父项目的名称)

    • ​Version​ ​: 默认 1.0-SNAPSHOT即可。

  4. ​完成创建​ ​:点击 Finish。IDEA 会创建一个最基础的 Maven 项目,里面只有一个 pom.xml文件。(会有.idea,src, pom.xml,直接删除src)

第二步:修改父项目的 pom.xml

这是最关键的一步,需要将打包方式改为 pom,并预先声明子模块。(这一步不修改也可以)

复制代码
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.sky</groupId>
    <artifactId>sky-take-out</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!-- 关键!打包方式必须为 pom -->
    <packaging>pom</packaging>

    <!-- 1. 在这里预先声明所有子模块 -->
    <modules>
        <module>sky-common</module>
        <module>sky-pojo</module>
        <module>sky-server</module>
    </modules>

    <!-- 2. 在这里统一管理所有模块的公共依赖版本 -->
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <spring-boot.version>2.7.18</spring-boot.version>
        <!-- 其他依赖版本 -->
    </properties>

    <!-- 3. 依赖管理(可选但推荐),子模块引用这里的依赖无需写版本 -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-parent</artifactId>
                <version>${spring-boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!-- 其他需要统一版本的依赖 -->
        </dependencies>
    </dependencyManagement>
</project>
第三步:创建子模块

现在,我们基于父项目来创建子模块。

  1. ​右键父项目​ ​:在 IDEA 的项目工具窗口中,右键点击父项目名称(sky-take-out)。

  2. ​新建模块​ ​:选择 New-> Module...

  3. ​同样选择Maven​ ​:和创建父项目一样,选择 Maven,不选 Archetype,点击 Next

  4. ​填写子模块坐标​​:

    • ​Name​ ​: sky-common(IDEA 会自动将 ArtifactId填充为同名)。

    • 注意看 ​​Parent​ ​ 一栏,应该已经自动显示为 com.sky:sky-take-out。这非常重要!

  5. ​完成创建​ ​:点击 Finish

重复步骤 1-5,依次创建 sky-pojosky-server模块。创建完成后,你的项目结构就会和图片中一模一样了。

💡 多模块项目设计思路(为什么这么分?)

理解每个模块的职责,对你后续开发和维护至关重要:

  • sky-common ​:​​公共工具模块​ ​。存放整个项目通用的类,如常量、工具类(DateUtils, StringUtils)、基础配置、异常处理、通用AOP等。​​所有其他模块都可以依赖它。​

  • sky-pojo ​:​​实体/模型模块​ ​。存放所有数据模型类,如与数据库表对应的Entity、前后端交互的DTO/VO、查询参数Query等。​sky-server会依赖它。​

  • sky-server ​:​​主应用模块​ ​。包含Spring Boot启动类、控制器Controller、业务服务Service、数据层Mapper/Repository、配置文件等。它是最终需要运行和打包的模块。​​它会依赖 sky-commonsky-pojo。​

✅ 验证与运行

创建完成后,在IDEA右侧的Maven工具窗口中,你应该能看到一个清晰的树形结构。你可以点击父项目的 Lifecycle中的 cleancompilepackage等命令,Maven会按照依赖顺序自动构建所有模块。

相关推荐
孟陬20 小时前
国外技术周刊 #1:Paul Graham 重新分享最受欢迎的文章《创作者的品味》、本周被划线最多 YouTube《如何在 19 分钟内学会 AI》、为何我不
java·前端·后端
想用offer打牌20 小时前
一站式了解四种限流算法
java·后端·go
华仔啊21 小时前
Java 开发千万别给布尔变量加 is 前缀!很容易背锅
java
也些宝1 天前
Java单例模式:饿汉、懒汉、DCL三种实现及最佳实践
java
Nyarlathotep01131 天前
SpringBoot Starter的用法以及原理
java·spring boot
wuwen51 天前
WebFlux + Lettuce Reactive 中 SkyWalking 链路上下文丢失的修复实践
java
SimonKing1 天前
GitHub 10万星的OpenCode,正在悄悄改变我们的工作流
java·后端·程序员
Seven971 天前
虚拟线程深度解析:轻量并发编程的未来趋势
java
雨中飘荡的记忆1 天前
ElasticJob分布式调度从入门到实战
java·后端