Apache Maven 是一款强大的项目管理和构建工具，广泛应用于 Java 开发中，它通过简单的配置文件（pom.xml）管理项目的依赖、构建流程和发布，本文将详细介绍如何在 Windows、macOS 和 Linux 系统上安装和配置 Maven，并验证安装是否成功。

安装前的准备工作

在安装 Maven 之前，确保你的系统已安装 Java Development Kit (JDK)，因为 Maven 是基于 Java 的工具，可以通过以下命令检查 Java 是否已安装：

java -version

如果未安装 JDK，请先下载并安装适合你系统的版本（推荐 JDK 8 或更高版本）。

下载 Maven

访问 Maven 的官方下载页面：https://maven.apache.org/download.cgi
选择最新稳定版本的 Binary zip archive（Windows 用户可选 zip，Linux/macOS 用户可选 tar.gz）。

安装 Maven

Windows 系统

1. 解压下载的压缩包（apache-maven-3.9.6-bin.zip）到指定目录，如 C:\Program Files\apache-maven-3.9.6。
2. 配置环境变量：
   • 右键 “此电脑” → “属性” → “高级系统设置” → “环境变量”。
   • 在 系统变量 中，新建变量 MAVEN_HOME，值为 Maven 的安装路径（如 C:\Program Files\apache-maven-3.9.6）。
   • 编辑 Path 变量，新增 %MAVEN_HOME%\bin。
3. 验证安装：
   打开命令提示符（CMD），运行：

   mvn -v

   如果显示 Maven 版本和 Java 信息，说明安装成功。

macOS / Linux 系统

1. 解压下载的压缩包（apache-maven-3.9.6-bin.tar.gz）到 /usr/local 目录：

   sudo tar -xzvf apache-maven-3.9.6-bin.tar.gz -C /usr/local

2. 配置环境变量：
   编辑 ~/.bashrc（或 ~/.zshrc）文件，添加以下内容：

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

   然后运行 source ~/.bashrc 使配置生效。

3. 验证安装：

   mvn -v

   如果正确显示版本信息，则安装成功。

配置 Maven 本地仓库（可选）

Maven 默认将依赖库存储在用户目录下的 .m2/repository 文件夹中，如果需要更改存储路径，可以修改 MAVEN_HOME/conf/settings.xml 文件：

<localRepository>/path/to/your/custom/repo</localRepository>

测试 Maven 项目

运行以下命令创建一个简单的 Maven 项目，验证是否正常工作：

mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

进入项目目录并编译：

cd my-app
 mvn package

如果构建成功，说明 Maven 已正确安装并运行。

常见问题及解决方案

• “mvn 不是内部或外部命令”：检查环境变量是否配置正确，尤其是 PATH 是否包含 Maven 的 bin 目录。
• Java 版本不兼容：确保 JDK 版本符合 Maven 要求（至少 JDK 7）。
• 网络问题导致依赖下载失败：可以配置国内镜像（如阿里云 Maven 镜像）加速下载。

Maven 的安装过程并不复杂，关键在于正确配置环境变量和验证安装，按照上述步骤操作后，你就可以顺利使用 Maven 管理 Java 项目了，无论是个人开发还是团队协作，Maven 都能极大提升项目构建和依赖管理的效率。

如果你在安装过程中遇到问题，可以参考官方文档或社区论坛寻求帮助，Happy Coding！ 🚀

(责任编辑：时讯)