# Maven-aggregation Quickstart

**Repository Path**: tingyuabc/maven-aggregation-quickstart

## Basic Information

- **Project Name**: Maven-aggregation Quickstart
- **Description**: Maven-aggregation Quickstart 是一个 IntelliJ IDEA 插件，用于快速生成标准的多模块 Maven 项目结构。通过该插件，你可以一键创建模块化项目，并自动配置模块间的依赖关系，同时支持自定义模块名称和 Java 版本，非常适合用于 Java 项目的快速启动。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 52
- **Forks**: 32
- **Created**: 2025-07-18
- **Last Updated**: 2025-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Maven-aggregation Quickstart

Maven-aggregation Quickstart 是一个 IntelliJ IDEA 插件，用于快速生成标准的多模块 Maven 项目结构。通过该插件，你可以一键创建模块化项目，并自动配置模块间的依赖关系，同时支持自定义模块名称和 Java 版本，非常适合用于 Java 项目的快速启动。

---

## 📌 主要功能

- **一键创建 Maven 多模块项目结构**
- **自动生成模块间的依赖关系**
- **支持自定义模块名称**
- **支持选择 Java 版本**
- **自动生成 README.md 和 .gitignore 文件**

---

## 🚀 使用方法

### 1. 安装插件

1. 打开 IntelliJ IDEA。
2. 进入 `Settings (Preferences)` > `Plugins`。
3. 点击 `Marketplace` 标签。
4. 搜索 `Maven-aggregation Quickstart`。
5. 点击 `Install` 安装插件。
6. 重启 IntelliJ IDEA。

### 2. 创建项目

1. 打开 IntelliJ IDEA。
2. 点击菜单 `File > New > Create Maven Aggregation Project`。
3. 填写以下信息：
    - GroupId: Maven 项目的组织标识（例如：`com.example`）
    - ArtifactId: 项目名称
    - Version: 项目版本（默认 `1.0.0`）
    - 模块名称：输入多个模块名称（例如：`api`, `service`, `pojo`）
    - Java 版本：选择项目使用的 Java 版本
4. 点击 `Finish`，插件会自动生成项目结构。

---

## 📁 项目结构示例

生成的项目目录结构如下：
your-project-name/ 
├── api/ 
├── service/ 
├── pojo/ 
├── common/ 
├── mapper

每个模块都包含以下标准目录结构：
module-name/ 
├── src/ │ 
├── main/ │ │ 
├── java/ Java 源代码 
│ │ └── resources/ 静态资源文件 
│ └── test/ │ ├── java/ 测试代码


---

## 🧩 模块说明

| 模块名称 | 说明 |
|---------|------|
| `api`     | 对外暴露的 API 接口模块 |
| `common`  | 公共工具类和通用组件模块 |
| `mapper`  | 数据访问层模块（通常用于数据库操作） |
| `pojo`    | 实体类模块 |
| `service` | 业务逻辑模块 |

> 注意：你可以自定义模块名称，插件会自动识别并生成对应描述。

---

## 🧪 构建项目

为了确保项目的顺利构建，请按照以下步骤操作：

1. **打开终端**：在你的项目根目录下打开一个新的终端窗口。
2. **执行 Maven 命令**：运行以下命令来清理并安装项目依赖。

```
mvn clean install


```


---

## 🛠️ 开发与构建插件

如果你希望修改插件或构建插件源码，请参考以下步骤：

### 1. 克隆仓库
```
git clone https://github.com/yourname/maven-aggregation.git
cd maven-aggregation

```

### 2. 构建插件

使用 Maven 构建插件：

```
mvn clean package

```

构建完成后，插件的 `.jar` 文件会生成在 `target/` 目录下。

### 3. 安装插件到 IntelliJ IDEA

1. 打开 IntelliJ IDEA。
2. 进入 `Settings (Preferences)` > `Plugins`。
3. 点击 `Install Plugin from Disk...`。
4. 选择 `target/maven-aggregation.jar`。
5. 安装并重启 IntelliJ IDEA.

---

## 📞 联系我们

如果你有任何问题或建议，请联系：

📧 Email: 1938023944@qq.com  
🌐 Website: [https://www.wandong.com](https://www.wandong.com)

---