自从用了这个IDEA插件，新建项目都是一键生成，10秒搞定，太香了！使用 IDEA 插件「Maven Aggregati

使用 IDEA 插件「Maven Aggregation Quickstart」一键创建多模块 Maven 项目

在微服务或分层架构开发中，新建一个标准的 Maven 多模块项目往往需要手动创建多个子模块、配置 pom.xml 依赖、调整目录结构，过程繁琐且易出错。本文将介绍一款开源 IDEA 插件 —— Maven Aggregation Quickstart，只需填写模块名称，30 秒内自动生成完整多模块项目结构，彻底告别重复劳动。

在这里插入图片描述

一、为什么需要这个插件？

传统方式创建 Maven 多模块项目存在以下痛点：

❌ 手动创建 api、service、common、pojo 等多个模块
❌ 依赖关系容易写反（如 service 依赖 api）
❌ 每个模块需手动创建 src/main/java 等标准目录
❌ 父 pom.xml 与子模块 pom.xml 配置易遗漏

💡 真实场景：新人实习生搭建一个 4 模块项目，折腾一下午仍未跑通；老手也需 30~40 分钟完成基础配置。

Maven Aggregation Quickstart 插件 正是为解决这些问题而生，它能：

✅ 按业务顺序自动建立模块依赖
✅ 自动生成标准 Maven 目录结构
✅ 自动配置父子 pom.xml
✅ 支持自定义 Java 版本、GroupId、ArtifactId

二、插件安装

方式 1：插件市场安装（推荐）

⚠️ 注：截至 2025 年，该插件已提交 JetBrains 插件市场，但部分版本仍需手动安装。建议优先尝试市场搜索。

打开 IDEA → File → Settings（Mac: Cmd + ,）
进入 Plugins → 切换到 Marketplace
搜索 Maven Aggregation Quickstart
点击 Install，安装完成后重启 IDEA

插件市场安装

方式 2：手动安装（离线环境）

从 Gitee 仓库下载最新 jar 包
IDEA → Settings → Plugins → 点击右上角 ⚙️ → Install Plugin from Disk...
选择下载的 jar 文件，重启 IDEA

✅ 要求：IDEA 2020.3 及以上版本

三、一键创建多模块项目

Step 1：启动创建向导

方法一：File → New → Create Maven Aggregation Project
方法二：在项目根目录右键 → New → Create Maven Aggregation Project

在这里插入图片描述

Step 2：填写项目信息

填写以下关键字段：

字段	示例	说明
GroupId	`com.example`	公司/组织域名倒写
ArtifactId	`user-center`	项目名，建议小写无空格
Version	`1.0.0`	默认即可
模块名称	`api,service,pojo,common`	按业务依赖顺序填写，用逗号分隔
Java 版本	`17`	推荐 11/17

🔑 关键技巧：模块顺序决定依赖关系！
插件会自动让 后一个模块依赖前一个，例如：

service 依赖 api

pojo 依赖 service

所有模块默认依赖 common

在这里插入图片描述

Step 3：自动生成项目结构

点击 Finish，插件将在 10~30 秒内完成以下操作：

创建父项目目录
生成标准多模块结构
自动配置所有 pom.xml
创建 .gitignore 和 README.md

生成的项目结构如下：

user-center/
├── api/
├── service/
├── pojo/
├── common/
├── pom.xml          # 父 pom
├── README.md
└── .gitignore

每个子模块均包含完整 Maven 目录：

api/
├── src/
│   ├── main/
│   │   ├── java/       # 源码目录
│   │   └── resources/  # 配置文件
│   └── test/
│       ├── java/       # 测试代码
│       └── resources/  # 测试资源
└── pom.xml             # 子模块 pom

在这里插入图片描述

四、高级用法

1. 自定义团队模板

插件使用 Velocity 模板 生成代码，支持团队定制：

找到插件安装目录（如 ~/.local/share/JetBrains/IntelliJIdea2024.2/plugins/maven-aggregation-quickstart）
修改 templates/ 下的 .vm 文件
重启 IDEA，新项目将使用自定义模板

✅ 适用场景：统一公司代码规范、添加默认注解、集成日志框架等

2. 修改 Java 版本

若需调整 Java 版本，只需修改父 pom.xml 中的编译配置：

<properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
</properties>

总结

Maven Aggregation Quickstart 插件将多模块项目搭建从“体力活”变为“一键操作”，特别适合：

🚀 快速启动新项目（个人/团队）
🧑‍🎓 新人培训标准化环境
🏗️ 微服务架构基础脚手架生成
📦 统一公司项目结构规范

效率对比：

传统方式：30~60 分钟，甚至一天

使用插件：10 秒

从此，你再也不用为“建项目”浪费宝贵开发时间。让重复工作自动化，把精力留给真正有价值的编码！