IntelliJ IDEA中Maven配置全指南

一、环境准备与基础配置

1.1 Windows 环境下载并配置 Maven

见此篇博文：环境配置

1.2 IDEA配置步骤

1. 打开设置面板：File → Settings → Build → Build Tools → Maven

2. 关键配置项：

   Maven home path = E:\apache-maven-3.9.9 （本地安装路径）
   User settings file = 自定义settings.xml路径（建议配置阿里云镜像）
   Local repository = 本地仓库路径（默认~/.m2/repository）
   

二、依赖管理实战技巧

2.1 创建 Maven 项目

1. 创建一个空工程

   

2. 创建模块，选择Java语言，选择Maven。 填写模块的基本信息

   

3. 创建项目，Maven 目录结构

   maven-project
   
           |---  src  (源代码目录和测试代码目录)
   
                 |---  main (源代码目录)
   
                 		|--- java (源代码java文件目录)
   
                       |--- resources (源代码配置文件目录)
   
                 |---  test (测试代码目录)
   
                       |--- java (测试代码java目录)
   
                       |--- resources (测试代码配置文件目录)
   
           |--- target (编译、打包生成文件存放目录)
   

2.2 pom.xml结构解析

<!-- 典型依赖配置示例 -->
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>4.0.0</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

2.3 依赖范围对照表

2.4 依赖冲突解决方案

• 查看依赖树：mvn dependency:tree
• IDEA可视化工具：右侧Maven面板 → 点击项目 → Show Dependencies

三、实例项目

一个包含前端基础（HTML + CSS + JS + Vue + Ajax）与后端 Web 基础的学习笔记，旨在帮助学习者通过示例代码和模块化结构深入理解 Web 开发的各个方面。项目适合初学者入门学习，也可以作为后续实际工作中的参考笔记

• github：https://github.com/AlivinFer/JavaWebLearning.git
• 见 day03-Maven 模块

四、生命周期深度解析

4.1 核心生命周期阶段

4.2 常用命令组合

• 快速打包：mvn clean package -DskipTests
• 部署到本地仓库：mvn clean install
• 跳过代码检查：mvn verify -Dcheckstyle.skip=true

五、高效开发最佳实践

1. 镜像加速配置（修改settings.xml）：

   <mirror>
     <id>aliyun</id>
     <mirrorOf>*</mirrorOf>
     <name>阿里云镜像</name>
     <url>https://maven.aliyun.com/repository/public</url>
   </mirror>
   

2. 多模块管理技巧：

   parent-project/
   ├── pom.xml（聚合pom）
   ├── module-core/
   │   └── pom.xml
   └── module-web/
       └── pom.xml
   

3. 版本管理策略：

   <properties>
     <spring.version>6.0.0</spring.version>
   </properties>
   
   <dependency>
     <groupId>org.springframework</groupId>
     <artifactId>spring-core</artifactId>
     <version>${spring.version}</version>
   </dependency>
   

六、常见问题排查

6.1 依赖下载失败

• 检查镜像配置
• 删除本地仓库残留文件：mvn dependency:purge-local-repository
• 强制更新快照版本：mvn -U clean install

5.2 构建卡顿

• 并行构建：mvn -T 1C clean install（使用与CPU核心数相同的线程）
• 跳过测试：-DskipTests=true