1. 概述

简单来说,Maven 是一个用于构建和管理任何基于 Java 的项目的命令行工具。

Maven 项目提供了一个预编译版本的 Maven 压缩文件,方便我们使用。它没有安装程序,我们需要自己设置必要的前提条件和环境,以便运行 Maven。

Apache Maven 的安装过程包括解压归档文件,然后配置 Maven 使 mvn 可执行文件出现在操作系统类路径中。

1.1. 先决条件

Maven 是用 Java 编写的,因此要运行 Maven,我们需要安装并正确配置 Java 环境。可以从 Oracle 下载站点下载与操作系统兼容的 Java JDK,例如。建议安装到不含空格的路径下。

安装 Java 后,我们需要确保 Java JDK 的命令在系统环境变量 PATH 中。

可以通过运行以下命令来查看当前安装的版本信息:

java -version

2. 在 Windows 上安装 Maven

要在 Windows 上安装 Maven,可以访问 Apache Maven 网站下载最新版本,选择例如 apache-maven-3.8.4-bin.zip 的 Maven 压缩文件。

然后,我们将它解压到希望 Maven 存放的文件夹中。

2.1. 将 Maven 添加到环境路径

我们使用系统属性为 Windows 环境添加 M2_HOMEMAVEN_HOME 变量,并指向我们的 Maven 文件夹。

接下来,通过将 Maven 的 bin 文件夹(%M2_HOME%\bin)追加到 PATH 变量中,确保可以在任何地方运行 Maven 命令。

验证方法是运行:

mvn -version

上述命令应该显示 Maven 版本、Java 版本和操作系统信息。至此,我们在 Windows 系统上设置了 Maven。

3. 在 Linux 上安装 Maven

在 Linux 操作系统上安装 Maven,可以从 Apache Maven 网站下载最新版本,选择例如 apache-maven-3.8.4-bin.tar.gz 的 Maven 可执行文件。

许多 Linux 发行版如 Redhat、Ubuntu 使用 BASH 作为默认 shell。下面的步骤将使用 BASH 命令。

首先,创建 Maven 的存储位置:

$ mkdir -p /usr/local/apache-maven/apache-maven-3.8.4

然后,将归档文件解压到 Maven 存储位置:

$ tar -xvf apache-maven-3.8.4-bin.tar.gz -C /usr/local/apache-maven/apache-maven-3.8.4

3.1. 将 Maven 添加到环境路径

打开命令终端,使用以下命令编辑 bashrc 文件:

$ nano ~/.bashrc

接下来,在文件中添加 Maven 相关行:

export M2_HOME=/usr/local/apache-maven/apache-maven-3.8.4 
export M2=$M2_HOME/bin 
export MAVEN_OPTS=-Xms256m -Xmx512m 
export PATH=$M2:$PATH

保存文件后,无需重启即可重新加载环境配置:

$ source ~/.bashrc

最后,检查 Maven 是否已添加:

$ mvn -version

输出应类似于:

Apache Maven 3.8.4 (81a9f75f19aa7275152c262bcea1a77223b93445; 2021-01-07T15:30:30+01:29)
Maven home: /usr/local/apache-maven/apache-maven-3.8.4

Java version: 1.8.0_75, vendor: Oracle Corporation

Java home: /usr/local/java-current/jdk1.8.0_75/jre

我们已经在 Linux 系统上成功安装了 Maven。

3.2. 在 Ubuntu 上安装 Maven

在终端中,运行 apt-cache search maven 获取所有可用的 Maven 包:

$ apt-cache search maven
....
libxmlbeans-maven-plugin-java-doc - Documentation for Maven XMLBeans Plugin
maven - Java software project management and comprehension tool
maven-debian-helper - Helper tools for building Debian packages with Maven
maven2 - Java software project management and comprehension tool

Maven 包总是包含最新的 Apache Maven。

运行 sudo apt-get install maven 安装最新版 Maven:

$ sudo apt-get install maven

这可能需要几分钟下载。下载完成后,我们可以运行 mvn -version 验证安装。

4. 在 Mac OS X 上安装 Maven

在 Mac OS X 操作系统上安装 Maven,从 Apache Maven 网站下载最新版本,选择例如 apache-maven-3.8.4-bin.tar.gz 的 Maven 归档文件。

然后解压到所需的目录。

4.1. 将 Maven 添加到环境路径

首先,打开终端并切换到解压文件的目录,然后以管理员身份登录。

其次,我们需要删除 tar.gz 归档文件:

rm Downloads/apache-maven*bin.tar.gz

接着,我们需要修复权限并切换 Maven 内容:

chown -R root:wheel Downloads/apache-maven* 
mv Downloads/apache-maven* /opt/apache-maven

然后,用 nano 编辑器将管理员会话存档并添加 Maven 可执行文件到路径:

exit 
nano $HOME/.profile 
export PATH=$PATH:/opt/apache-maven/bin

最后,使用 Ctrl+x 保存并退出 nano

为了加载新设置,运行:

bash

现在,我们使用以下命令检查 Maven 是否安装成功:

mvn -version

现在我们已经准备好在 Mac OS X 上使用 Maven。

4.2. 在 macOS Catalina 或更高版本上添加 Maven 到环境路径

macOS 已放弃大多数 GNU/Linux 发行版使用的 Bourne-Again Shell (bash),转而使用 Z shell (zsh)。Z shell 可以看作是 bash 的扩展版本,以其先进的命令补全机制、拼写纠正和模块系统而著称。

对于 macOS Catalina 或更高版本,由于默认 shell 是 zsh,我们需要将 Maven 添加到不同的文件中:

nano ~/.zshenv  
export PATH=$PATH:/opt/apache-maven/bin

为了重新加载环境,需要运行:

source ~/.zshenv 

其余操作保持不变。

4.3. 对于 HighSierra 兼容性

对于 HighSierra,除了上述操作外,还需要额外将 Maven 可执行文件添加到路径:

nano $HOME/.bashrc
export PATH=$PATH:/opt/apache-maven/bin

使用 Ctrl+x 保存并退出 nano。然后运行 bash 加载新设置。

5. 结论

在这篇文章中,我们学习了如何在主要操作系统上安装 Maven 开发环境。

要了解如何使用 Spring 和 Maven 开始,可以参考教程:这里