Maven 安装与配置指南（适用于 Windows、Linux 和 macOS）

Apache Maven 是一款广泛应用于 Java 项目的项目管理和构建工具。 本文提供在 Windows、Linux 和 macOS

系统上安装与配置 Maven 的详细步骤，旨在帮助开发者快速搭建高效的构建环境。

一、前置条件：安装 Java Development Kit (JDK)

Maven 依赖于 Java 运行环境，安装前需确保系统已安装 JDK（建议版本为 JDK 8 或更高）。

检查 JDK 安装情况

在终端或命令提示符中执行以下命令：

java -version

若系统返回 Java 版本信息，表示已正确安装 JDK。 若未安装，请先安装适合系统的 JDK 并配置相应的环境变量。

二、下载 Maven

访问 Apache Maven 官方下载页面：

https://maven.apache.org/download.cgi

选择最新稳定版本的二进制压缩包：(阿里云)

• Windows：下载 .zip 文件
• Linux/macOS：下载 .tar.gz 文件(腾讯云)

  建议下载最新稳定版本（例如：3.9.9）。

  ---

  三、安装与配置 Maven

  1. 解压安装包

  将下载的压缩包解压至指定目录，路径中避免包含空格或非 ASCII 字符。

  示例路径：

  • Windows：C:\Program Files\apache-maven-3.9.9
  • Linux/macOS：/usr/local/apache-maven-3.9.9

    2. 配置环境变量

    Windows 系统

    1. 设置系统环境变量 MAVEN_HOME，值为 Maven 的安装路径，例如：

       C:\Program Files\apache-maven-3.9.9

    2. 编辑系统环境变量 Path，添加：

       %MAVEN_HOME%\bin

    Linux/macOS 系统

    1. 打开终端，编辑用户主目录下的 shell 配置文件：

       • Bash：~/.bashrc
       • Zsh：~/.zshrc

       • 在文件末尾添加以下内容：(阿里云)

         export MAVEN_HOME=/usr/local/apache-maven-3.9.9
         export PATH=$MAVEN_HOME/bin:$PATH
         

       • 保存文件并使配置生效：

         source ~/.bashrc  # 或 source ~/.zshrc
         

    ---

    四、验证 Maven 安装

    在终端或命令提示符中执行以下命令：

    mvn -version
    

    若系统返回 Maven 的版本信息，表示安装成功。

    ---

    五、配置国内镜像源（可选）

    为提高依赖包下载速度，可配置国内镜像源。

    1. 打开 Maven 安装目录下的 conf/settings.xml 文件。

    2. 在 标签中添加以下内容：

         aliyunmaven
         *
         阿里云公共仓库
         https://maven.aliyun.com/repository/public
       
       

    配置完成后，Maven 将优先从阿里云镜像下载依赖，提高下载速度。

    ---

    六、配置本地仓库路径（可选）

    默认情况下，Maven 将下载的依赖包存储在用户主目录下的 .m2/repository 目录中。 若需更改本地仓库位置，可在 settings.xml 文件中修改 标签：

    /path/to/your/repository
    

    将 /path/to/your/repository 替换为期望的本地仓库路径。

    ---

    七、在 IntelliJ IDEA 中配置 Maven（可选）

    1. 打开 IntelliJ IDEA，进入：

       File > Settings > Build, Execution, Deployment > Build Tools > Maven

    2. 在 Maven home directory 中，选择 Maven 的安装路径。

    3. 在 User settings file 中，选择配置了镜像源的 settings.xml 文件。

    4. 点击 Apply 和 OK 保存配置。

    配置完成后，IntelliJ IDEA 将使用指定的 Maven 设置进行项目构建和依赖管理。

    ---

    通过以上步骤，Maven 已在系统中成功安装并配置完毕。 可开始使用 Maven 管理和构建 Java 项目。

    更多 Maven 使用方法和最佳实践，参考官方文档：

    https://maven.apache.org/guides/index.html

    ---