Maven精讲

一、Maven 简介

Maven 是 Apache 旗下的一个开源项目管理工具，主要用于 Java 项目的构建、依赖管理和文档生成。它通过一个标准化的项目结构和一个 XML 文件（pom.xml）来管理项目的生命周期，解决了传统构建工具（如 Ant）配置复杂、依赖管理困难等问题。其核心功能包括：

• 标准化项目结构：自动生成统一、标准的项目目录结构，降低学习成本。
• 依赖管理：自动处理项目所需第三方库的下载、版本冲突解决和传递性依赖管理。
• 项目构建：提供clean、compile、test、package、install等标准化生命周期流程。
• 信息管理：通过pom.xml集中管理项目配置、构建规则和文档生成。
• 多模块支持：支持父子POM结构实现大型项目拆分管理。
• 插件扩展：通过插件实现编译、测试、打包等任务。

二、Maven 安装与配置

1. 安装步骤

1. 下载 Maven：从 Apache Maven 官网 下载最新版本（如 apache-maven-3.8.1-bin.zip）。
2. 解压安装：解压到指定目录（如D:\apache-maven-3.8.1）。
   
3. 配置环境变量：
   • 添加MAVEN_HOME指向安装目录。
   • 将%MAVEN_HOME%\bin添加到PATH环境变量。
     
4. 验证安装：命令行执行mvn -v，显示版本信息即安装成功。
   • 输出的Java版本信息反映了Maven运行所依赖的JDK版本，而非项目编译或运行时的目标Java版本。
   • 不同版本的Maven对JDK有不同的最低要求。例如，Maven 3.8.x及以上版本需要JDK 1.7或更高版本运行。
   • 如果要修改mvn -v输出的Java版本，需要更改JAVA_HOME环境变量，使其指向所需的JDK路径。
     

2. 仓库配置

1. 配置本地仓库：
   • 运行maven命令，会在用户目录下自动创建本地仓库 C:\Users<用户名>.m2\repository，随着项目开发下载构件至本地仓库，文件会越来越大，占用大量C盘空间，这里在D盘创建文件夹repository，并配置本地仓库路径
     
2. 中央仓库
   • 这个仓库由 Maven 社区管理。
   • 无需显式配置，默认地址：https://repo.maven.apache.org/maven2/。
   • 需要通过网络才能访问。
3. 配置远程仓库
   • 由于中央仓库在国外，所以下载jar包速度可能比较慢，而阿里公司提供了一个远程仓库，里面基本也都有开源项目的jar包。
     

3. 构件下载一半失败的情况

当Maven依赖包下载到一半失败时，通常是由于网络中断、仓库服务器问题或本地缓存损坏等原因导致，此时会生成以.lastUpdated为扩展名的临时文件，阻碍后续重新下载。

删除.lastUpdated文件

• 手动删除：

  • 找到本地Maven仓库路径。
  • 搜索所有以.lastUpdated结尾的文件并删除。例如：

    find~/.m2/repository-name"*.lastUpdated"-delete

  • 或使用Windows批处理脚本（clearLastUpdated.bat）：

    @echo off set REPO_PATH=%USERPROFILE%\.m2\repository for /r "%REPO_PATH%" %%i in (*.lastUpdated) do del "%%i" pause

• 强制更新：

  • 在命令行中添加-U参数，强制Maven检查更新并重新下载：

    mvn cleaninstall-U

三、创建 Maven 项目

1. 使用命令创建项目

下面图中等同于执行以下命令
mvn archetype:generate -DgroupId=com.example -DartifactId=my-first-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false -DarchetypeVersion=RELEASE

2.Mavenarchetype:generate参数表

3. 项目模板

DarchetypeArtifactId用于指定 Maven 原型的标识符，不同的值代表不同类型的项目模板。以下是一些常见的DarchetypeArtifactId值及其用途的表格展示：

4. 项目结构

my-first-app/ ├── pom.xml # Maven 项目配置文件 ├── src/ │ ├── main/ # 主代码目录 │ │ └── java/ # Java 源代码 │ │ └── com/example/App.java # 自动生成的示例类 │ └── test/ # 测试代码目录 │ └── java/ # 测试类 │ └── com/example/AppTest.java # 自动生成的测试类

四、认识POM

• POM ( Project Object Model，项目对象模型 ) 是 Maven 的核心配置文件，采用 XML 格式，默认命名为 pom.xml。
• 所有的 POM 都继承自一个父（Super）POM（无论是否显式定义了这个父 POM）。父POM是 Maven 默认的 POM。父 POM 包含了一些可以被继承的默认设置。因此，当 Maven 发现需要下载 POM 中的 依赖时，它会到 Super POM 中配置的默认仓库 https://repo.maven.apache.org/maven2 去下载。
• Maven 使用 effective pom（Super pom 加上工程自己的配置）来执行相关的目标，它帮助开发者在 pom.xml 中做尽可能少的配置，当然这些配置可以被重写。

1. 查看effective pom

• 使用以下命令来查看完整的pom配置：

  mvn help:effective-pom

2. POM 标签大全

以下是整合后的pom.xml标签分类详解表格，涵盖基础信息、依赖管理、构建配置、环境配置、多模块管理及其他信息六大类，包含标签、类别、说明、示例/可选值及是否必需的详细说明：

五、Maven 的三大生命周期

Maven 的生命周期分为 Clean、Default（Build） 和 Site 三类，每个生命周期由多个阶段（Phase）组成，按顺序执行。

1. Clean 生命周期

作用：清理项目生成的临时文件（如target目录）。
包含阶段：

1. pre-clean：执行清理前的准备工作。
2. clean：删除target目录（默认阶段）。
3. post-clean：执行清理后的收尾工作。

常用命令：

mvn clean# 执行 clean 阶段（清理 target 目录）

2. Default（Build）生命周期

作用：构建项目（编译、测试、打包、安装等），是最常用的生命周期。
关键阶段（按顺序执行）：

常用命令：

mvn compile# 编译主代码mvntest# 编译并运行测试（不打包）mvn package# 编译、测试并打包（生成 target/xxx.jar）mvninstall# 打包并安装到本地仓库mvn deploy# 打包并部署到远程仓库

3. Site 生命周期

作用：生成项目文档和站点报告（如代码质量分析、测试覆盖率等）。
包含阶段：

1. pre-site：生成站点前的准备工作。
2. site：生成项目文档（默认阶段，输出到target/site）。
3. post-site：生成站点后的收尾工作。
4. site-deploy：将站点部署到服务器（如 GitHub Pages）。

常用命令：

mvn site# 生成项目文档mvn site-deploy# 部署站点到远程服务器

4. 关键注意事项

1. 阶段顺序：Maven 生命周期阶段是顺序执行的，例如mvn package会隐式执行validate→compile→test→package。
2. 跳过测试：使用-DskipTests跳过测试（如mvn package -DskipTests）。
3. 指定版本：通过versions-maven-plugin批量修改版本号（如mvn versions:set -DnewVersion=1.1.0）。
4. 依赖分析：用mvn dependency:tree检查依赖冲突（如[WARNING] Dependency conflict）。
5. 多模块项目：在根目录执行命令会递归应用到所有子模块（如mvn clean install）。

六、快照(SNAPSHOT)

在 Maven 中，快照（Snapshot） 是一种特殊的版本号机制，主要用于 开发阶段 的依赖管理。它的核心作用是 允许项目动态引用其他模块的最新开发版本，而无需频繁修改版本号。

1.使用场景

一个大型的软件应用通常包含多个模块，并且通常的场景是多个团队开发同一应用的不同模块。举个例子，设想一个团队开发应用的前端，项目为 app-ui(app-ui.jar:1.0)，而另一个团队开发应用的后台，使用的项目是>2. 快照vs正式版本号

3. 版本号示例对比

4.总结