Maven 作为一款广泛使用的 Java 项目管理和构建工具，其版本管理功能对于项目的稳定性和可维护性至关重要，掌握 Maven 版本相关的命令，能够帮助开发者高效地管理项目依赖、插件以及 Maven 自身的版本，本文将详细介绍 Maven 版本相关的核心命令，包括查看当前版本、更新 Maven 版本、管理项目依赖版本以及处理版本冲突等方面的内容。
了解当前安装的 Maven 版本是最基础的操作，通过在命令行中输入 mvn -v 或 mvn --version，可以快速查看 Maven 的版本信息、Java 版本、操作系统架构等详细内容，执行该命令后，通常会输出类似 Apache Maven 3.8.1 (cdiv5f82c3e732ffatmaven.apache.org) 的版本号，以及 Java 版本如 1.8.0_312，这些信息对于确保项目构建环境的一致性非常重要，特别是在团队协作或跨平台开发时，需要确保所有成员使用的 Maven 版本兼容。
当需要更新 Maven 版本时，可以通过手动下载或使用包管理器进行，手动下载的方式是访问 Maven 官方仓库（https://maven.apache.org/download.cgi），下载对应操作系统的二进制压缩包，然后解压到指定目录，并配置环境变量 PATH 添加 Maven 的 bin 目录，使用包管理器则更为便捷，例如在 Linux 系统中，可以通过 sudo apt update && sudo apt install maven（适用于 Debian/Ubuntu）或 sudo yum install maven（适用于 CentOS/RHEL）来安装或更新 Maven，更新后，同样可以通过 mvn -v 命令验证新版本是否生效。
在 Maven 项目中，管理依赖版本的核心是 pom.xml 文件中的 <dependencyManagement> 和 <dependencies> 标签。<dependencyManagement> 用于定义依赖的版本号，但不会直接引入依赖，它主要作用是在子模块或多个依赖中统一版本，在父 POM 中定义 <dependencyManagement>，子模块引用依赖时无需指定版本，会自动继承父 POM 中定义的版本，而 <dependencies> 标签则用于直接引入项目所需的依赖，此时需要指定依赖的groupId、artifactId 和 version，为了简化版本管理，Maven 推荐使用属性（properties）来定义版本号，例如在 <properties> 标签中定义 <spring.version>5.3.20</spring.version>，然后在依赖引用时使用 ${spring.version}，这样当需要统一更新某个框架版本时，只需修改 properties 中的值即可。
Maven 提供了多个命令用于管理依赖版本，mvn dependency:tree 是最常用的命令之一，该命令会以树状结构输出项目的所有依赖及其传递依赖，并显示每个依赖的版本，通过分析依赖树，可以快速发现版本冲突或冗余依赖，当两个不同的依赖传递引入了同一 artifact 但不同版本时，Maven 会根据“最近定义优先”原则选择版本，这可能导致潜在的兼容性问题，可以使用 mvn dependency:tree -Dverbose 查看更详细的版本信息，或通过 mvn dependency:analyze 分析依赖的使用情况,找出未使用或声明的依赖。
解决版本冲突时，可以使用 <exclusions> 标签排除传递依赖中的特定版本依赖，依赖 A 引入了依赖 B 的 1.0 版本，但项目需要依赖 B 的 2.0 版本，可以在依赖 A 的配置中添加 <exclusions><exclusion><groupId>com.example</groupId><artifactId>dependency-b</artifactId></exclusion></exclusions>，然后在项目的 <dependencies> 中直接引入依赖 B 的 2.0 版本，Maven 的 dependencyManagement 也可以强制统一版本，即使传递依赖引入了不同版本，也会被 <dependencyManagement> 中定义的版本覆盖。
对于 Maven 插件的版本管理，与依赖版本管理类似，可以在 <build> 标签中使用 <pluginManagement> 来统一插件的版本，定义 <pluginManagement><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.8.1</version></plugin></plugins></pluginManagement>，这样在项目构建时，所有模块都会使用该版本的编译插件，也可以通过 mvn help:describe -Dplugin=org.apache.maven.plugins:maven-compiler-plugin -Ddetail 查看插件的详细信息和可用参数。
在项目构建过程中，有时需要强制更新依赖版本，可以使用 mvn dependency:resolve 或 mvn dependency:go-offline 命令，前者会解析并下载所有依赖，后者则会下载所有依赖和插件，以便离线构建，使用 mvn versions:display-dependency-updates（需要安装 Maven Versions Plugin）可以检查依赖是否有可用的更新版本,帮助开发者保持依赖的最新状态。
以下是一些常用的 Maven 版本相关命令及其功能说明：
| 命令 | 功能描述 |
|---|---|
mvn -v 或 mvn --version |
查看 Maven 版本及环境信息 |
mvn dependency:tree |
输出项目依赖树，查看依赖版本 |
mvn dependency:analyze |
分析依赖使用情况，找出未使用或声明的依赖 |
mvn dependency:resolve |
解析并下载项目依赖 |
mvn help:describe -Dplugin=<plugin> |
查看插件的详细信息 |
mvn versions:display-dependency-updates |
检查依赖的可用更新版本 |
相关问答FAQs：
-
问：如何解决 Maven 依赖传递导致的版本冲突？ 答：解决 Maven 依赖版本冲突可以采取以下方法：使用
mvn dependency:tree命令查看依赖树，定位冲突的依赖；在依赖的 POM 配置中使用<exclusions>标签排除不需要的传递依赖；在父 POM 的<dependencyManagement>中统一定义依赖版本，强制覆盖传递依赖的版本；确保直接引入的依赖版本符合项目需求，必要时可以手动调整依赖的声明顺序，利用 Maven“最近定义优先”的原则选择版本。 -
问：如何批量更新 Maven 项目的依赖版本？ 答：批量更新 Maven 项目依赖版本可以使用 Maven Versions Plugin 提供的功能，在项目的 POM 文件中添加该插件的依赖，然后在命令行中执行
mvn versions:use-latest-releases（更新所有依赖到最新发布版本）或mvn versions:use-latest-versions（更新到最新版本，包括快照版本），如果需要更新特定依赖，可以使用mvn versions:use-latest-releases -Dincludes=<groupId>:<artifactId>命令，也可以通过编辑<properties>标签中的版本属性，然后使用mvn versions:update-properties命令批量更新所有引用该属性的依赖版本。
