[架构之美]IntelliJ IDEA创建Maven项目全流程（十四）

[架构之美]IntelliJ IDEA创建Maven项目全流程（十四）

摘要：本文将通过图文结合的方式，详细讲解如何使用IntelliJ IDEA快速创建Maven项目，涵盖环境配置、项目初始化、依赖管理及常见问题解决方案。适用于Java开发新手及需要快速上手的开发者。

一、环境准备

1.1 所需软件

• JDK 8+（推荐JDK 11/17）
• IntelliJ IDEA 2021.3+（社区版/旗舰版均可）

1.2 验证环境

# 检查Java版本
java -version

# 检查Maven（IDEA内置无需单独安装）
mvn -v

二、创建Maven项目（6步图解）

步骤1：打开IDEA创建新项目

1. 启动IDEA → 点击 New Project

2. 选择左侧 Maven → 点击 Next直至项目创建成功

   

步骤2：配置项目信息

GroupId: com.example    # 组织标识（如公司域名倒写）
ArtifactId: demo        # 项目名称
Version: 1.0-SNAPSHOT   # 默认版本号

步骤3：选择项目存储位置

指定项目存放目录（建议路径不要包含中文/空格）

创建时选择项目位置：

步骤4：设置Maven路径

• 指定本地安装的Maven路径

步骤5：等待初始化完成

首次创建时会自动下载依赖（观察底部进度条）

步骤6：查看项目结构

生成的标准目录结构：

src
├── main
│   ├── java         # 源代码目录
│   └── resources    # 资源文件目录
└── test
    ├── java         # 测试代码目录
pom.xml              # Maven核心配置文件

三、配置Maven优化设置

3.1 修改镜像源（加速依赖下载）

本地安装好maven后可打开 conf/settings.xml，添加阿里云镜像：

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

四、编写与测试代码

4.1 创建示例类

在 src/main/java 新建 HelloWorld.java：

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello Maven!");
    }
}

4.2 添加依赖示例（以JUnit 5为例）

修改 pom.xml：

<dependencies>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.9.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

4.3 运行项目

1. 右键点击 HelloWorld.java
2. 选择 Run ‘HelloWorld.main()’

五、常见问题解答（Q&A）

Q1：依赖下载失败怎么办？

• 检查网络连接
• 确认镜像源配置正确
• 执行 mvn clean install -U

Q2：插件版本冲突如何解决？

• 在 pom.xml 中指定明确版本号
• 使用 mvn dependency:tree 分析依赖树

Q3：目录结构不符合规范？

• 手动创建缺失目录
• 右键目录 → Mark Directory as 设置类型

六、总结

通过本文，您已经掌握了：

• Maven项目的创建流程
• 依赖管理配置技巧
• 常见问题的排查方法

TIP：建议定期执行 mvn clean install 保持项目健康状态，关注Maven中央仓库的版本更新。

希望本教程对您有帮助，请点赞❤️收藏⭐关注支持！欢迎在评论区留言交流技术细节！