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_HOME 和 MAVEN_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 开始,可以参考教程:这里。