一、环境准备与基础配置
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