安装和配置 Maven 教程

本文讨论的 Maven 是目前最新发布版本: Apache Maven 3.9.8

系统要求

以下是该安装该版本的系统要求:

JDK: Maven 3.9+需要使用 JDK 8 或更高版本来执行。它仍然允许您通过使用工具链来针对 1.3 和其他 JDK 版本进行构建;

内存:无最低要求;

硬盘:Maven 安装本身大约需要 10MB 的空间。此外,还会根据使用情况为您的本地 Maven 仓库使用磁盘空间。您的本地仓库大小将根据使用情况而有所不同,但至少需要 500MB。

操作系统:无最低要求。启动脚本包含为 shell 脚本(在许多 Unix 变体上测试过)和 Windows 批处理文件。

Maven 官方下载地址:https://maven.apache.org/download.cgi

在 Windows 中安装

下载 Maven

对于 Windows 系统,需要下载 “Binary zip archive” 包,通常格式为 apache-maven-x.x.x-bin.zip,本文下载的包为: apache-maven-3.9.8-bin.zip

安装 Maven

解压已下载的 apache-maven-3.9.8-bin.zip,将解压后的得到的文件夹apache-maven-3.9.8,转移到合适的位置。通常情况下,我是把该解压文件夹放在 D:\dev-env\maven 下。

由于下载的是二进制压缩包,解压该包后无需安装,直接使用。因此,我的 Maven 安装目录是D:\dev-env\maven\apache-maven-3.9.8

配置 Maven 系统环境变量

为了能在任意位置使用 Maven,我们需要在系统环境变量中添加 MAVEN_HOME 系统环境变量,并将 Maven 的 bin 目录添加到 Path 系统环境变量中;

配置系统变量

我的电脑=>鼠标右键=>属性=>高级系统设置=>环境变量=>系统变量

  • 新建系统变量,变量名: MAVEN_HOME,变量值:D:\dev-env\maven\apache-maven-3.9.8
  • 变更系统变量,变量名:Path,在原变量值追加:D:\dev-env\maven\apache-maven-3.9.8\bin

验证是否安装成功

键入 Win + R 打开命令行提示符窗口(DOS 界面),输入 mvn --version,出现以下图示中内容则配置成功。

“验证maven是否安装成功”

配置 Maven 本地仓库

在 Maven 配置(文件夹为conf)文件中,找到配置文件 settings.xml,编辑该文件,使用 localRepository 标签指定 Maven 本地仓库的地址:

<!-- localRepository
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ${user.home}/.m2/repository
  <localRepository>/path/to/local/repo</localRepository>
  -->
  <localRepository>D:\dev-env\maven\repos</localRepository>

配置 Maven 阿里云镜像仓库

由于默认情况下 Maven 访问国外的仓库下载 jar 包,为了防止在中国国内使用 Maven 时,下载 jar 包太慢,我们需要将其变更为阿里云 Maven[1] 镜像仓库。

编辑 Maven 配置文件settings.xml,在 mirros 标签中,添加阿里云镜像仓库的配置:

<mirror>
    <id>public-aliyun</id>
    <mirrorOf>public</mirrorOf>
    <name>Aliyun public</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

在 Linux 中安装

先通过 SSH 远程连接工具,连接到 Linux 系统,我使用的是系统自带的终端工具,通过以下命令行: ssh user@ip

> ssh user@ipaddress

其中 user 为登录用户名,ipaddress 为 Linux 访问 IP 地址

下载 Maven

通过以下命令行下载 Maven Linux 安装包apache-maven-3.9.8-bin.tar.gz

> wget https://dlcdn.apache.org/maven/maven-3/3.9.8/binaries/apache-maven-3.9.8-bin.tar.gz

安装 Maven

将已下载的安装包放在磁盘的 /usr/local/ 目录下,解压安装包:

> tar -zxvf apache-maven-3.9.8-bin.tar.gz

由于下载的是二进制压缩包,解压该包后无需安装,直接使用。

配置 Maven 环境变量

为了能正常使用 Maven,需要在系统环境变量中添加 MAVEN_HOME 系统环境变量,并将 Maven 的 bin 目录添加到 PATH 系统环境变量中。

编辑 /etc/profile 文件,即 vi /etc/profile,添加以下内容:

export MAVEN_HOME=/usr/local/apache-maven-3.9.8
export PATH=${PATH}:${MAVEN_HOME}/bin

其中 ${PATH} 要使用原 PATH 内容替换。保存上述配置后,输入以下命令使配置生效:

> source /etc/profile

我们可以通过命令 mvn -v,验证 Maven 是否可以正常使用。

其它的配置与 Windows 安装相同。


  1. 参考阿里云 Maven 使用指南:https://developer.aliyun.com/mvn/guide