maven安装

bug君原创2025/7/2...大约 4 分钟

摘要

本文详细介绍了Maven的安装配置过程，包括与JDK的版本对应关系、下载方式（官网和国内网盘）、在Windows和Linux/Mac系统上的安装步骤、环境变量配置方法及其作用，以及安装验证和常见问题排解。通过本教程，读者可以轻松完成Maven的安装部署，为Java项目的构建和依赖管理打下基础。

1. 与JDK版本对应关系

Maven的不同版本需要与特定的JDK版本相匹配。以下是主要的Maven版本与所需JDK版本的对应关系：

Maven版本	所需JDK版本
Maven 4.x	JDK 17+
Maven 3.9.x	JDK 8+
Maven 3.8.x	JDK 8+
Maven 3.6.x - 3.8.x	JDK 7+
Maven 3.3.x	JDK 7+
Maven 3.2.5	JDK 6+
Maven 3.0 - 3.2.4	JDK 5+
Maven 2.x	JDK 1.4 - 1.7

补充说明

更详细的Maven版本历史信息可以在官方文档中查看：Maven版本历史

2. 下载

温馨提示

当你无法访问maven官网时，可以在网盘中获取

2.1 官网下载

访问Maven官方下载页面
选择适合您操作系统的二进制压缩包：
- apache-maven-[版本号]-bin.zip (Windows用户)
- apache-maven-[版本号]-bin.tar.gz (Linux/Mac用户)
image-20250703152323077

2.2 网盘下载

网盘中含有linux和windows 3.9.10安装包

夸克网盘：https://pan.quark.cn/s/228870924a9c

百度网盘：https://pan.baidu.com/s/1A7YmoULEslPt5wzdial4_A?pwd=uz4c 提取码: uz4c

3. 安装

3.1 Windows系统安装

解压下载的zip文件到您选择的目录
确保您的系统中已经正确安装了JDK
注意保存Maven解压后的路径，如：D:\Apache\maven

3.2 Linux/Mac系统安装

温馨提示

建议将Maven安装在一个没有空格和中文的路径中，这可以避免潜在的路径问题。

打开终端

使用以下命令解压tar.gz文件：

tar -xzvf apache-maven-3.9.10-bin.tar.gz

将解压后的文件夹移动到适当的位置：
```
sudo mv apache-maven-3.9.10 /opt/maven
```

4. 添加环境变量

配置环境变量是使Maven在命令行中全局可用的关键步骤。

4.1 Windows系统环境变量配置

右键点击"此电脑"或"我的电脑"，选择"属性"
点击"高级系统设置"
在"系统属性"窗口中，选择"高级"选项卡，然后点击"环境变量"
在"系统变量"区域，点击"新建"按钮
创建一个名为MAVEN_HOME的新变量，其值为Maven的安装目录（例如：D:\Apache\maven）
编辑系统变量Path，点击"新建"，添加%MAVEN_HOME%\bin
点击"确定"保存所有更改

4.2 Linux/Mac系统环境变量配置

编辑环境配置文件（根据您的shell选择适当的文件）：
```
# Bash用户
nano ~/.bashrc

# Zsh用户
nano ~/.zshrc
```

在文件末尾添加以下内容：

export MAVEN_HOME=/opt/maven
export PATH=$PATH:$MAVEN_HOME/bin

保存并关闭文件
使环境变量生效：
```
source ~/.bashrc  # 或 source ~/.zshrc
```

4.3 环境变量作用

配置环境变量的主要作用包括：

允许在命令行中全局访问Maven命令，不需要每次使用完整路径
为其他依赖Maven的工具提供必要的配置信息
让Maven知道JDK的安装位置（通过JAVA_HOME变量）
便于多版本Maven的管理和切换

5. 验证安装

安装完成后，验证Maven是否正确安装并可以使用：

打开命令行终端（Windows的命令提示符或PowerShell，或Linux/Mac的终端）
输入以下命令：
```
mvn -v
```

如果安装成功，您将看到类似以下的输出：

Apache Maven 3.9.10 (5f519b97e944483d878815739f519b2eade0a91d)
Maven home: /opt/maven
Java version: 17.0.2, vendor: Oracle Corporation
Java home: /usr/lib/jvm/java-17-openjdk
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "5.15.0", arch: "x86_64", family: "unix"

这表明Maven已成功安装，并且系统已正确配置环境变量。输出信息包含了Maven版本、Maven安装路径、Java版本与供应商、Java安装路径、默认区域设置、平台编码以及操作系统信息。