Maven 常用命令

Maven 是一个强大的项目管理和构建自动化工具，它使用 pom.xml 文件来管理项目的构建、报告和文档。

Maven 构建命令以 mvn 开头，后面添加功能参数，可以一次执行多个命令，使用空格分隔。

基础构建命令

命令	说明
mvn clean	清理项目，删除 target 目录下的所有生成文件
mvn compile	编译项目的源代码
mvn test	运行项目的单元测试（使用 maven-surefire-plugin）
mvn package	将编译后的代码打包，生成 JAR、WAR 等格式的分发包
mvn install	将打包的构件安装到本地 Maven 仓库，供其他本地项目使用
mvn deploy	将打包的构件部署到远程仓库，如公司私服或 Maven 中央仓库

以上命令按生命周期顺序执行，执行后面的命令会自动执行前面的命令。例如 mvn install 会依次执行 compile → test → package → install。

项目生成命令

命令	说明
mvn archetype:generate	从 Maven 原型生成器创建一个新的 Maven 项目
mvn eclipse:eclipse	生成 Eclipse 项目文件（.classpath 和 .project）
mvn idea:idea	生成 IntelliJ IDEA 项目文件

依赖分析命令

命令	说明
mvn dependency:list	列出项目的所有已解析依赖项
mvn dependency:tree	以树形结构显示项目的依赖关系，用于分析依赖冲突
mvn dependency:resolve	解析所有依赖项并显示解析结果
mvn dependency:analyze	分析项目依赖，检测未使用和未声明的依赖

版本与插件管理命令

命令	说明
mvn versions:display-dependency-updates	显示项目依赖项的可用版本更新
mvn versions:display-plugin-updates	显示 Maven 插件的可用版本更新
mvn enforcer:enforce	执行 Maven 强制规则检查

文档生成命令

命令	说明
mvn site	生成项目的网站文档和报告

常用参数

参数	说明
-U	强制更新 SNAPSHOT 依赖项
-X	调试模式，输出详细的调试信息
-DskipTests	跳过测试执行（但仍会编译测试代码）
-Dmaven.test.skip=true	跳过测试执行和测试代码编译
-DskipITs	跳过集成测试
-pl <module>	指定构建特定模块（Projects List）
-am	同时构建所依赖的模块（Also Make）
-amd	同时构建依赖于该模块的模块（Also Make Dependents）
-P <profile>	激活指定的 Maven Profile
-V	显示 Maven 版本信息
-o	离线模式，不访问远程仓库
-T <n>	多线程构建，-T 4 表示使用 4 个线程

-DskipTests 和 -Dmaven.test.skip=true 的区别：

• -DskipTests：跳过测试执行，但仍然会编译测试代码。
• -Dmaven.test.skip=true：跳过测试执行和编译，完全忽略测试。

常用组合命令

# 清理项目并安装到本地仓库
mvn clean install

# 清理项目并打包
mvn clean package

# 清理项目并运行单元测试
mvn clean test

# 清理项目并编译源代码
mvn clean compile

# 清理、跳过测试并安装到本地仓库
mvn clean install -DskipTests

# 强制更新快照依赖并打包
mvn clean package -U

# 多模块项目中构建指定模块及其依赖模块
mvn clean install -pl module-a -am

# 激活指定 Profile 进行构建
mvn clean install -P prod

获取帮助

# 查看 Maven 帮助信息
mvn -h

# 查看 Maven 帮助插件的详细帮助
mvn help:help

# 查看当前项目的有效 POM
mvn help:effective-pom

# 查看当前项目的有效 settings.xml
mvn help:effective-settings