Maven在不同操作系统上如何安装？

news2025/1/9 5:06:29

大家好，我是袁庭新。Maven是一个重要的工具，还有很多初学者竟然不知道如何安装Maven？这篇文章将系统介绍如何在Windows、macOS、Linux操作系统上安装Maven。

Maven是一个基于Java的项目管理工具。因此，最基本的要求是在计算机上安装了JDK，JDK的安装这里暂不介绍。

1.Maven软件下载

使用Maven管理工具，我们首先要到官网去下载Maven的安装软件。Maven下载网址http://maven.apache.org/download.cgi，这里我们以Maven 3.8.4为例。

在编写这套教程的时候，目前最新版是apache-maven-3.8.4-bin.zip或apache-maven-3.8.4-bin.tar.gz版本，根据操作系统提前下载好了对应的Maven版本。

2.Maven软件安装

Apache Maven的安装过程很简单，只需解压存档文件（开箱即用），并使用mvn命令将bin文件夹添加到Path环境变量中即可。

在任何目录中提取分发文件（即将Maven解压到合适的位置即可）：

unzip apache-maven-3.8.4-bin.zip

或者：

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

解压文件尽量不要放在含有中文或特殊字符或有空格的目录下（比如解压到H:\software目录下）。Maven安装包解压后目录结构如下：

解压后得到apache-maven-3.8.4目录，对该目录下的文件解释说明见下：

目录	描述
bin	存放了Maven的命令文件，含有mvn运行的脚本
boot	存放了一些Maven本身的引导程序，如plexus-classworlds类加载器框架，Maven使用该框架加载自己的类库
conf	存放了Maven的一些配置文件，如settings.xml配置文件
lib	存放了Maven本身运行所需的一些jar包文件

3.Maven环境变量配置

将解压Maven的apache-maven-3.8.4目录下的bin目录添加到Path环境变量中。

3.1 Windows配置Maven环境变量

1.打开系统属性（WinKey + Pause），选择【高级】选项卡下的【环境变量】选项，新建一个【MAVEN_HOME】变量名，变量值为Maven的安装目录。

H:\software\apache-maven-3.8.4

2.将MAVEN_HOME添加到Path系统变量中。

%MAVEN_HOME%\bin

3.打开一个新的命令提示符（Winkey + R然后键入cmd）并运行mvn -v以验证Maven是否配置成功。

# 查看Maven工具的版本信息
mvn -v
# 或者使用以下命令也可查看Maven工具的版本信息
mvn -version

3.2 Unix配置Maven环境变量

基于Unix的操作系统（Linux、Solaris和Mac OS X）配置方式相同，下面以Mac OS系统为例进行配置说明。

3.2.1 MAC配置Maven环境变量步骤

1.打开Mac终端，输入以下命令编辑用户主目录下的.bash_profile启动脚本文件（或.zshrc启动脚本文件），具体根据你使用的Shell。使用vim编辑器编辑启动脚本。

vim ~/.bash_profile

注意：如果指定的文件不存在，则输入touch ~/.bash_profile 命令创建新的空白文件，然后再输入上面的命令。

2.打开.bash_profile文件后，按下i键进入到输入模式，在启动脚本下添加如下两行命令。

export MAVEN_HOME=/Users/yuanxin/Documents/ProgramSoftware/apache-maven-3.8.4
export PATH=$MAVEN_HOME/bin:$PATH

3.然后按下esc键退出插入模式，然后再输入:wq命令，敲击回车按键，保存并退出该文件。

4.为了让我们刚刚添加的环境变量生效，使用source命令加载环境变量，使.bash_profile文件生效。

source ~/.bash_profile

5.配置完成后，你可以通过运行以下命令来验证Maven安装是否成功。

yuanxin@yuanxindeMacBook-Pro ~ % mvn -v
Apache Maven 3.8.4 (9b656c72d54e5bacbed989b64718c159fe39b537)
Maven home: /Users/yuanxin/Documents/ProgramSoftware/apache-maven-3.8.4
Java version: 11.0.12, vendor: Oracle Corporation, runtime: /Library/Java/JavaVirtualMachines/jdk-11.0.12.jdk/Contents/Home
Default locale: zh_CN_#Hans, platform encoding: UTF-8
OS name: "mac os x", version: "11.4", arch: "x86_64", family: "mac"

6.如果输出结果如下所示，证明Maven配置成功。如果没有，检查路径是否正确，或者版本号名称等。

3.2.2 问题zsh: command not found: mvn解决

如果出现，新打开的终端输入mvn -v指令，报"zsh: command not found: mvn"错，然后重新输入source ~/.bash_profile指令后，又恢复正常的问题。是由于Mac系统的升级，新的环境变量读取方式走的是zsh，所以才会存在以上问题。解决的方法见下。

1.在Mac的终端执行以下命令。

vi ~/.zshrc

2.在.zshrc文件末尾追加以下内容（如果没有该文件则直接创建，并追加以下内容保存即可）。

source ~/.bash_profile

3.最后再次执行.zshrc让配置生效。

source ~/.zshrc

3.2.3 Mac上有3处可以设置环境变量

具体介绍见下表：

文件	描述
/etc/profile	系统全局变量，系统启动即加载该文件的配置（不建议添加）
/etc/bashrc	所有类型的bash shell都会读取该文件的配置
~/.bash_profile	配置用户级环境变量，在系统用户文件夹下创建，当用户登录时，该文件会被执行且仅执行一次