Maven 常用命令大全（2025 最新版）
一句话记住：
“mvn clean package -Pprod -DskipTests 一条命令完成全部构建！”
一、核心命令（10 个必须掌握）
| 命令 | 作用 | 说明 |
|---|
mvn clean | 清理项目 | 删除 target/ 目录 |
mvn compile | 编译主代码 | 生成 target/classes |
mvn test | 运行单元测试 | 使用 JUnit/Mockito |
mvn package | 打包 | 生成 target/xxx.jar 或 .war |
mvn install | 安装到本地仓库 | 供其他项目依赖 |
mvn deploy | 发布到远程仓库 | 如 Nexus、Artifactory |
mvn verify | 集成测试 | 运行 failsafe 插件 |
mvn site | 生成项目报告 | Javadoc、测试覆盖率 |
mvn dependency:tree | 查看依赖树 | 解决冲突神器 |
mvn help:effective-pom | 查看最终 POM | 包含继承、Profile 合并后 |
二、一键组合命令（日常开发）
| 场景 | 命令 | 说明 |
|---|
| 本地开发打包 | mvn clean package | 清理 + 编译 + 测试 + 打包 |
| 快速打包（跳过测试） | mvn clean package -DskipTests | 提升 3~5 倍速度 |
| 生产发布 | mvn clean deploy -Pprod | 激活生产 Profile |
| 强制更新依赖 | mvn clean install -U | -U 强制从远程仓库更新 |
| 离线构建 | mvn clean package -o | -o 不联网，使用本地仓库 |
三、参数详解（-D / -P）
| 参数 | 含义 | 示例 |
|---|
-DskipTests | 跳过单元测试 | mvn package -DskipTests |
-Dmaven.test.skip=true | 跳过测试 + 编译测试代码 | mvn package -Dmaven.test.skip=true |
-Pdev | 激活 Profile | mvn package -Pdev |
-P!dev | 禁用 Profile | mvn package -P!dev |
-pl :module-a | 只构建指定模块 | mvn install -pl :service |
-am | 同时构建依赖模块 | mvn install -pl :web -am |
四、调试与诊断命令
| 命令 | 作用 |
|---|
mvn -X | 开启调试日志，查看详细执行过程 |
mvn dependency:analyze | 分析未使用/重复依赖 |
mvn dependency:resolve | 解析依赖（不下载） |
mvn versions:display-plugin-updates | 检查插件更新 |
mvn help:system | 显示系统和环境信息 |
五、多模块项目命令（大型项目必备）
# 1. 从根模块构建所有子模块
mvn clean install
# 2. 只构建某个模块
mvn install -pl :service-user
# 3. 构建模块 + 它的依赖
mvn install -pl :web -am
# 4. 构建依赖它的模块
mvn install -pl :service-user -amd
-pl = project list
-am = also make
-amd = also make dependents
六、Spring Boot 专属命令
| 命令 | 作用 |
|---|
mvn spring-boot:run | 热启动，开发神器 |
mvn spring-boot:repackage | 打包成可执行 JAR |
mvn spring-boot:start / stop | 集成测试时启动/停止 |
# 开发时热部署
mvn spring-boot:run -Dspring-boot.run.profiles=dev
七、插件目标命令（Plugin Goals）
# 执行特定插件目标
mvn groupId:artifactId:version:goal
# 示例
mvn org.apache.maven.plugins:maven-compiler-plugin:3.13.0:compile
mvn com.spotify:docker-maven-plugin:1.2.0:build
八、命令速查表（复制粘贴）
# 基础
mvn clean
mvn compile
mvn test
mvn package
mvn install
mvn deploy
# 组合
mvn clean package
mvn clean install -U
mvn clean package -DskipTests
mvn clean package -Pprod
# 调试
mvn -X package
mvn dependency:tree
mvn help:effective-pom
# 多模块
mvn install -pl :web
mvn install -pl :service -am
# Spring Boot
mvn spring-boot:run
mvn spring-boot:repackage
九、IDEA / VS Code 快捷键
| IDE | 快捷方式 |
|---|
| IntelliJ IDEA | 右键 pom.xml → Maven → Reimport |
| VS Code | 打开 Maven 面板 → 点击 install |
十、常见问题 & 解决方案
| 问题 | 命令 |
|---|
| 依赖下载慢 | 配置阿里云镜像 |
| 依赖冲突 | mvn dependency:tree → <exclusions> |
| 测试卡住 | mvn test -DforkCount=0 |
| 内存溢出 | export MAVEN_OPTS="-Xmx2g" |
十一、一句话总结
“clean package install deploy + -P + -D = 掌控一切！”
恭喜！你已掌握 Maven 所有常用命令！
下一步推荐
| 方向 | 内容 |
|---|
| CI/CD 集成 | Jenkins Pipeline 使用 Maven |
| Docker 构建 | dockerfile-maven-plugin |
| Nexus 私有仓库 | mvn deploy 发布 |
需要 Jenkins + Maven 流水线脚本？
回复 Jenkins Maven 立即获取！