下载与解压

1. 获取安装包

访问 Maven 官方下载页面，选择最新的稳定版本（Stable）。

• 版本选择

  • 推荐下载 .zip (Windows) 或 .tar.gz (Linux/Mac) 格式的二进制分发包（Binary zip/tar.gz）。

  • 避免下载源码包（Source），除非你需要编译 Maven 本身。

2. 解压安装

将下载的安装包解压到指定的磁盘目录。

• 路径规范：

  • 严禁包含中文字符、空格或特殊符号（如 @, #, &）。

  • 推荐路径示例：

    • Windows: D:\DevTools\apache-maven-3.8.6

    • Linux/Mac: /opt/apache-maven-3.8.6 或 ~/tools/apache-maven-3.8.6

• 错误示范：D:\软件\maven 3.8 (包含中文和空格，会导致脚本执行失败)。

3. 目录结构

解压后，你将看到以下关键目录，理解它们的作用对后续配置至关重要：

配置环境变量

为了让系统在任意路径下都能识别 mvn 命令，需要配置两个环境变量：MAVEN_HOME 和 PATH。

1. 新建 MAVEN_HOME

此变量指向 Maven 的安装根目录。

• 变量名：MAVEN_HOME ( 或 M2_HOME)

• 变量值：你的解压路径，例如 D:\DevTools\apache-maven-3.8.6

2. 更新 PATH 变量

将 Maven 的 bin 目录添加到系统路径中，以便在命令行直接调用。

• 变量名：PATH

• 操作：在现有变量值末尾追加 %MAVEN_HOME%\bin (Windows) 或 $MAVEN_HOME/bin (Linux/Mac)。

• 注意：多个路径之间需用分号 ; (Windows) 或冒号 : (Linux/Mac) 分隔。

3. 前置条件检查

Maven 依赖 Java 运行环境。在执行 Maven 命令前，请确保已正确配置 JAVA_HOME 环境变量，指向 JDK 的安装目录（而非 JRE）。

• 验证方法：在终端输入 java -version，若能显示版本号则说明 Java 环境正常。

验证安装

配置完成后，打开新的命令提示符（Windows）或终端（Linux/Mac），输入以下命令：

mvn -v

关键信息

• Maven home：必须显示为你配置的 MAVEN_HOME 路径。

• Java version：显示的 JDK 版本必须符合当前 Maven 版本的要求。

• 若出现 'mvn' 不是内部或外部命令 错误，请检查 PATH 变量是否配置正确，并确认是否重启了终端窗口。

配置优化

Maven 的全局配置文件位于 conf/settings.xml。为了适应国内网络环境并规范项目管理，建议进行以下两项关键配置。

最佳实践提示：
建议不要直接修改 Maven 安装目录下的 conf/settings.xml。
更好的做法是将该文件复制到用户主目录下的 .m2 文件夹中（即 ~/.m2/settings.xml 或 C:\Users\<用户名>\.m2\settings.xml）。
原因：这样在升级 Maven 版本时，你的个性化配置不会丢失，且不同项目可以共用同一套用户级配置。

1. 配置自定义本地仓库

默认情况下，Maven 会将下载的 JAR 包存储在 C:\Users\<用户名>\.m2\repository。随着项目增多，C 盘空间可能不足。我们可以将其修改到其他磁盘分区。

操作步骤：
编辑 settings.xml，找到 <localRepository> 标签（默认被注释），取消注释并修改路径：

<!-- 设置本地仓库路径为 D 盘专用目录 -->
<localRepository>D:\DevTools\apache-maven-3.8.6\repo</localRepository>

知识点补充：

• 该目录将由 Maven 自动创建，无需手动建立。

• 所有通过 Maven 下载的依赖包、插件以及通过 mvn install 安装的本地包都将存储在此处。

2. 配置阿里云镜像加速

Maven 中央仓库位于国外，国内直接下载依赖速度极慢甚至超时。阿里云提供了高速镜像服务，涵盖了中央仓库的绝大多数资源。

操作步骤：
在 settings.xml 中找到 <mirrors> 标签，在其中添加如下配置：

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <name>Aliyun Maven Mirror</name>
        <!-- 阿里云公共仓库地址 -->
        <url>https://maven.aliyun.com/repository/public</url>
        <mirrorOf>central</mirrorOf>
    </mirror>
</mirrors>

配置详解：

• <id>：镜像的唯一标识符，可自定义，但必须唯一。

• <url>：镜像服务器的地址。推荐使用 HTTPS 协议以保证安全性。

• <mirrorOf>：指定该镜像替代哪个仓库。central 表示替代默认的中央仓库。若设置为 *，则替代所有远程仓库（需谨慎使用，可能会影响私有仓库的访问）。

进阶技巧：
如果项目中还需要访问其他特定的远程仓库（如 Spring 官方仓库），可以在 <mirrors> 中添加更多条目，或者在项目的 pom.xml 中单独配置 <repositories>，Maven 会智能匹配。