手把手教你安装Maven_如何安装maven-虹桥书吧

手把手教你安装Maven_如何安装maven

时间：2025-07-04 20:54:10 来源：虹桥书吧作者：宏观研究

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

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

java -version

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

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

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

解压下载的压缩包（apache-maven-3.9.6-bin.tar.gz）到 /usr/local 目录：
```
sudo tar -xzvf apache-maven-3.9.6-bin.tar.gz -C /usr/local
```
配置环境变量：
编辑 ~/.bashrc（或 ~/.zshrc）文件，添加以下内容：
```
export MAVEN_HOME=/usr/local/apache-maven-3.9.6
 export PATH=$PATH:$MAVEN_HOME/bin
```
然后运行 source ~/.bashrc 使配置生效。
验证安装：
```
mvn -v
```
如果正确显示版本信息，则安装成功。

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

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

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

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

进入项目目录并编译：

cd my-app
 mvn package

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

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

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

(责任编辑：黄金TD)