IntelliJIDEA中Maven配置全指南

---

一、环境准备与基础配置 1.1 Windows 环境下载并配置 Maven

见此篇博文：环境配置

1.2 IDEA配置步骤

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

关键配置项：

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

---

二、依赖管理实战技巧 2.1 创建 Maven 项目

创建一个空工程

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

创建项目，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 依赖范围对照表 Scope编译测试运行典型用例compile✔️✔️✔️核心依赖（如Spring）test✖️✔️✖️测试框架（JUnit）provided✔️✔️✖️容器提供（如Servlet）runtime✖️✔️✔️JDBC驱动 2.4 依赖冲突解决方案 查看依赖树：mvn dependency:treeIDEA可视化工具：右侧Maven面板 → 点击项目 → Show Dependencies

---

三、实例项目

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

github： github /AlivinFer/JavaWebLearning.git见 day03-Maven 模块 四、生命周期深度解析 4.1 核心生命周期阶段 #mermaid-svg-9lmINm1JkL74B7ow {font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#mermaid-svg-9lmINm1JkL74B7ow .error-icon{fill:#552222;}#mermaid-svg-9lmINm1JkL74B7ow .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-9lmINm1JkL74B7ow .edge-thickness-normal{stroke-width:2px;}#mermaid-svg-9lmINm1JkL74B7ow .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-9lmINm1JkL74B7ow .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-9lmINm1JkL74B7ow .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-9lmINm1JkL74B7ow .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-9lmINm1JkL74B7ow .marker{fill:#333333;stroke:#333333;}#mermaid-svg-9lmINm1JkL74B7ow .marker.cross{stroke:#333333;}#mermaid-svg-9lmINm1JkL74B7ow svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-9lmINm1JkL74B7ow .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-9lmINm1JkL74B7ow .cluster-label text{fill:#333;}#mermaid-svg-9lmINm1JkL74B7ow .cluster-label span{color:#333;}#mermaid-svg-9lmINm1JkL74B7ow .label text,#mermaid-svg-9lmINm1JkL74B7ow span{fill:#333;color:#333;}#mermaid-svg-9lmINm1JkL74B7ow .node rect,#mermaid-svg-9lmINm1JkL74B7ow .node circle,#mermaid-svg-9lmINm1JkL74B7ow .node ellipse,#mermaid-svg-9lmINm1JkL74B7ow .node polygon,#mermaid-svg-9lmINm1JkL74B7ow .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-9lmINm1JkL74B7ow .node .label{text-align:center;}#mermaid-svg-9lmINm1JkL74B7ow .node.clickable{cursor:pointer;}#mermaid-svg-9lmINm1JkL74B7ow .arrowheadPath{fill:#333333;}#mermaid-svg-9lmINm1JkL74B7ow .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-9lmINm1JkL74B7ow .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-9lmINm1JkL74B7ow .edgeLabel{background-color:#e8e8e8;text-align:center;}#mermaid-svg-9lmINm1JkL74B7ow .edgeLabel rect{opacity:0.5;background-color:#e8e8e8;fill:#e8e8e8;}#mermaid-svg-9lmINm1JkL74B7ow .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-9lmINm1JkL74B7ow .cluster text{fill:#333;}#mermaid-svg-9lmINm1JkL74B7ow .cluster span{color:#333;}#mermaid-svg-9lmINm1JkL74B7ow div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-9lmINm1JkL74B7ow :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} clean validate compile test package install deploy 4.2 常用命令组合 快速打包：mvn clean package -DskipTests部署到本地仓库：mvn clean install跳过代码检查：mvn verify -Dcheckstyle.skip=true

---

五、高效开发最佳实践

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

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

多模块管理技巧：

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

版本管理策略：

<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