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 命令探索更多功能。
