千秋万雪今犹在
冷河孤舟不复来
在微服务或分层架构开发中,新建一个标准的 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
二、插件安装
插件市场安装
- 打开 IDEA →
File → Settings(Mac:Cmd + ,) - 进入
Plugins→ 切换到Marketplace - 搜索
Maven Aggregation Quickstart - 点击
Install,安装完成后重启 IDEA
三、一键创建多模块项目
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 分钟,甚至一天
使用插件:1 0 秒
从此,你再也不用为“建项目”浪费宝贵开发时间。让重复工作自动化,把精力留给真正有价值的编码!
