一、环境准备与基础配置
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: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
五、高效开发最佳实践
-
镜像加速配置（修改settings.xml）：
<mirror> <id>aliyun</id> <mirrorOf>*</mirrorOf> <name>阿里云镜像</name> <url>https://maven.aliyun.com/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
