如何正确执行Maven命令？

环境准备（先决条件）

1. 安装Java
   Maven依赖Java环境：

   • 下载JDK 8+（Oracle官网 或 OpenJDK）

   • 配置环境变量：

     # Windows：系统属性 → 环境变量
     JAVA_HOME = C:\Program Files\Java\jdk-17
     # Linux/macOS：添加到 ~/.bashrc 或 ~/.zshrc
     export JAVA_HOME=/usr/lib/jvm/jdk-17
     export PATH=$JAVA_HOME/bin:$PATH

2. 安装Maven

   • 下载Maven 3.6.3+（官网）

   • 配置环境变量：

     # Windows
     M2_HOME = C:\apache-maven-3.8.6
     PATH = %M2_HOME%\bin;%PATH%
     # Linux/macOS
     export M2_HOME=/opt/apache-maven-3.8.6
     export PATH=$M2_HOME/bin:$PATH

   • 验证安装：

     mvn -v  # 输出Maven及Java版本即成功

mvn 命令基础结构

mvn [选项] <生命周期阶段> [<生命周期阶段>...]

• 选项（Options）：控制Maven行为的参数（如 -D 定义属性）。
• 生命周期阶段（Phase）：Maven构建流程的步骤（如 compile、test）。

核心生命周期命令

Maven构建基于生命周期模型,常用阶段如下：
| 命令 | 作用 | 示例 |
|———————|——————————-|———————–|
| mvn clean | 删除target目录（清理构建） | mvn clean |
| mvn compile | 编译主代码 | mvn compile |
| mvn test | 运行单元测试 | mvn test |
| mvn package | 打包项目（JAR/WAR） | mvn package |
| mvn install | 安装到本地仓库 | mvn install |
| mvn deploy | 部署到远程仓库（如Nexus） | mvn deploy |
| mvn verify | 集成测试 | mvn verify |

链式执行：

mvn clean package  # 先清理再打包
mvn test install   # 运行测试后安装到本地

常用选项（参数）

实战示例

1. 跳过测试并打包：

   mvn clean package -DskipTests

2. 激活生产配置并部署：

   mvn clean deploy -Pprod

3. 多模块构建：

   # 仅构建module-a及其依赖
   mvn install -pl module-a -am

常见问题解决

1. 命令未找到（mvn: command not found）

   • 检查PATH环境变量是否包含Maven的bin目录。
   • 重启终端或执行 source ~/.bashrc（Linux/macOS）。

2. 依赖下载失败

   • 使用 -U 强制更新：mvn -U clean install。
   • 检查网络或镜像配置（~/.m2/settings.xml）。

3. 构建错误（如编译失败）

   • 添加 -e 或 -X 查看详细日志：mvn compile -e。
   • 确认JDK版本与pom.xml中<java.version>一致。

4. 插件执行报错

   • 更新Maven版本（兼容性问题）。
   • 检查插件配置（如maven-compiler-plugin）。

最佳实践

1. 优先使用官方仓库：配置阿里云镜像加速（修改settings.xml）：

   <mirror>
     <id>aliyun</id>
     <url>https://maven.aliyun.com/repository/public</url>
     <mirrorOf>central</mirrorOf>
   </mirror>

2. 定期清理本地仓库：
   • 删除 ~/.m2/repository 中无用依赖（节省空间）。
3. 使用Wrapper避免环境问题：

   mvn wrapper:wrapper   # 生成mvnw脚本（跨平台兼容）
   ./mvnw clean install  # 代替mvn命令

引用说明

• Maven官方文档：Apache Maven Documentation
• JDK安装指南：Oracle Java Documentation
• 环境变量配置：Maven Installation Guide
• 阿里云镜像仓库：Maven Mirror Settings
  基于Maven 3.8.6及Java 17验证，遵循Apache Maven最佳实践，建议定期查阅官方文档获取更新。