Maven 常用命令详解：从入门到精通

1. Maven 简介

Maven 是一个强大的项目管理和构建自动化工具，广泛应用于 Java 项目开发。它通过一个名为pom.xml（Project Object Model）的配置文件来管理项目的构建、依赖和文档。掌握 Maven 命令是高效使用 Maven 的基础。

2. 核心命令分类

2.1 项目生命周期命令

Maven 基于生命周期（Lifecycle）进行构建，每个生命周期包含多个阶段（Phase）。执行某个阶段会自动执行其之前的所有阶段。

• clean：清理项目，删除target目录。
• validate：验证项目是否正确且所有必要信息可用。
• compile：编译项目的源代码。
• test：使用合适的单元测试框架运行测试。
• package：将编译后的代码打包成可分发的格式，如 JAR、WAR。
• verify：对集成测试的结果进行检查，确保质量达标。
• install：将包安装到本地仓库，供本地其他项目依赖。
• deploy：将最终的包复制到远程仓库，供其他开发者和项目共享。

2.2 依赖管理命令

• dependency:tree：显示项目的依赖树，用于分析依赖传递和冲突。
• dependency:analyze：分析项目中使用但未声明的依赖，以及声明但未使用的依赖。
• dependency:copy-dependencies：将项目依赖复制到指定目录。

2.3 插件与帮助命令

• help:effective-pom：显示实际生效的 POM（合并了父 POM 和 settings.xml 等）。
• help:describe：描述插件的属性。
• versions:display-dependency-updates：检查依赖是否有新版本。

3. 常用命令详解与示例

3.1 清理与编译

# 清理项目 mvn clean 编译项目 mvn compile 清理后编译 mvn clean compile

3.2 运行测试

# 运行所有测试 mvn test 运行指定测试类 mvn test -Dtest=TestClassName 运行指定测试方法 mvn test -Dtest=TestClassName#methodName

3.3 打包与安装

# 打包项目（生成 JAR/WAR） mvn package 跳过测试进行打包 mvn package -DskipTests 安装到本地仓库 mvn install 清理、编译、测试、打包、安装全流程 mvn clean install

3.4 依赖分析

# 查看依赖树 mvn dependency:tree 查看依赖树，并过滤出某个依赖 mvn dependency:tree -Dincludes=groupId:artifactId 分析依赖使用情况 mvn dependency:analyze

4. 高级用法与技巧

4.1 多模块项目构建

# 在父目录下构建所有模块 mvn clean install 仅构建指定模块 mvn clean install -pl module-name 构建指定模块及其依赖模块 mvn clean install -pl module-name -am

4.2 跳过测试与跳过编译

# 跳过测试（不编译测试代码，也不运行测试） mvn clean install -DskipTests 跳过测试编译（编译测试代码，但不运行） mvn clean install -Dmaven.test.skip=true 仅编译，不运行测试和打包 mvn clean compile

4.3 指定配置文件与属性

# 使用指定 profile 构建 mvn clean install -Pprod 指定系统属性 mvn clean install -DpropertyName=value 查看生效的 POM mvn help:effective-pom

5. 常见问题与排查

• 依赖下载失败：检查网络、仓库配置（settings.xml），或尝试清理本地仓库（~/.m2/repository）后重试。
• 构建速度慢：合理使用-o（离线模式）、-T（线程数）参数，或配置镜像仓库。
• 版本冲突：使用dependency:tree分析，在 POM 中通过<exclusions>排除冲突依赖。

6. 总结

Maven 命令是项目构建的基石。从基础的clean、compile、package、install，到依赖分析的dependency:tree，再到高级的多模块构建和属性配置，熟练掌握这些命令能极大提升开发效率。建议在日常开发中结合具体场景多加练习，并善用mvn help命令探索更多功能。