Maven安装和配置教程（macOS版）

以下提供两种方式安装Maven，任选一种方式安装即可：

方式一：通过SDKMAN!安装Maven

一、安装前检查

请确保电脑上已经安装了SDKMAN!和JDK 8，需要安装的小伙伴点击下方链接查看安装教程：

SDKMAN!	JDK 8
点我查看	点我查看

二、安装Maven

1. 执行如下命令查看可以安装的Maven版本：

sdk list maven

下图中提供了各个版本的Maven，翻到页面最下方，这里我安装的3.6.3版本的Maven，按照下图中选中复制版本号：

提示：

• 上、下键可以翻页，或者按PageUp或PageDown翻页，按Q键退出。
• 推荐安装Maven 3.5及以上的版本。截止至2024年9月30日，Maven 4.0是测试版本，可能会有各种各样的bug，并且Maven 4.0版本需要安装JDK 17及以上的版本。

2. 执行如下命令，安装3.6.3版本的Maven：

sdk install maven 3.6.3

3. 安装完成，执行如下命令查看Maven版本：

mvn -v

三、配置Maven

前面我们已经安装好Maven，但是我们在以后导入依赖的时候默认使用的是Maven的中央仓库，而中央仓库是国外网站，下载速度比较慢。因此我们需要将Maven下载源设置成国内镜像仓库，提高导入依赖的速度。以下是下载源配置教程。

1. 这里我在Home目录中专门创建一个文件夹来存放Maven依赖：

mkdir -p $HOME/maven/repository

2. 使用vim命令编辑Maven配置文件settings.xml：

vim $HOME/.sdkman/maven/3.6.3/conf/settings.xml

3. 执行如下命令并回车，开启行号显示（命令在左下角显示）：

:set nu

4. 复制下面代码：

<profile>
    <id>jdk-1.8</id>
    <activation>
        <activeByDefault>true</activeByDefault>
        <jdk>1.8</jdk>
    </activation>
    <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
    </properties>
</profile>

5. 按i进入编辑模式，在第246行末尾换行，将上一步代码按Shift和Insert键粘贴到247行中，效果如下图：

此时我们配好了Maven的全局JDK版本，使用的是JDK 8版本。

6. 复制下面的代码：

这段代码的含义是将Maven下载依赖源更改为国内的阿里云，可以大幅加快下载速度。

<mirror>
    <id>nexus-aliyun</id>
    <mirrorOf>central</mirrorOf>
    <name>Nexus aliyun</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>

7. 在第158行末尾处换行，粘贴上一步代码，效果如下图：

8. 跳转到第55行，创建一个<localRepository></localRepository>标签，并在二者中间填写第一步你创建的Maven依赖路径，效果如下图所示：

9. 至此，Maven配置完成，按Esc键退出编辑模式，按:wq保存并退出。

方式二：正常安装Maven

一、安装前检查

1. 检查电脑上是否安装JDK，如果没有安装，请查看JDK安装教程：点我查看

2. 如果你已经安装了JDK，打开终端，输入java -version，按一下回车，查看JDK安装信息，如果有下面提示信息，说明JDK安装成功

二、下载Maven

以下两种方式二选一：

方式一：网盘下载（强烈推荐，下载速度较快！）

打开此链接：点击下载，密码:1024，选择任意一个文件下载即可，这里我选择的是3.6.3版本的：

方式二：官网下载（不推荐，曾经同事和我吐槽由于官网是国外的，下载速度非常慢）

1. 点击进入官网下载链接：点击进入，会出现如下界面

2. 选择一个，点击进入，这里我以3.6.3版本的为例，按下图所示操作即可：

说明：source目录下的文件是Maven的源码文件，如果有查看的源码的小伙伴，也可以点击进入下载，这里就不过多赘述了。

3. 使用macOS的小伙伴，点击.tar.gz文件下载（如下图）：

三、安装并配置Maven环境变量

1. 打开终端，将下载好的安装包（这里我下载到了~/Downloads/目录）移动到/usr/local目录下：

sudo mv Downloads/apache-maven-3.6.3-bin.tar.gz /usr/local

使用sudo命令可能需要输入用户密码。

2. 切换到/usr/local目录下：

cd /usr/local

3. 解压当前的压缩包：

sudo mkdir apache-maven-3.6.3 && sudo tar -zxvf apache-maven-3.6.3-bin.tar.gz 

4. 创建一个软连接（类似Windows快捷方式），方便我们后续快速切换目录：

sudo ln -s apache-maven-3.6.3 maven

5. 切换到安装目录：

cd maven

6. 在当前目录下创建一个maven_env.sh文件：

sudo vim maven_env.sh

7. 复制如下代码：

#MAVEN_HOME  
MAVEN_HOME=/usr/local/maven
PATH=$PATH:$MAVEN_HOME/bin
export PATH MAVEN_HOME

8. 按i键进入编辑模式，按Shift和Insert键粘贴上一步的代码，效果如下图所示：

9. 完成后按一下Esc键，然后输入:wq保存并退出。

10. 执行如下命令，让环境变量配置生效：

source maven_env.sh

11. 执行如下命令即可查看当前Maven版本：

mvn -v

四、配置Maven

前面我们已经配置好Maven，但是我们在以后导入依赖的时候默认使用的是Maven的中央仓库，而中央仓库是国外网站，下载速度比较慢。因此我们需要将Maven下载源设置成国内镜像仓库，提高导入依赖的速度。以下是下载源配置教程。

1. 这里我在Maven目录中专门创建一个文件夹来存放Maven依赖：

sudo mkdir -p /usr/local/maven/repository

2. 使用vim命令编辑Maven配置文件settings.xml：

sudo vim /usr/local/maven/conf/settings.xml

3. 执行如下命令并回车，开启行号显示（命令在左下角显示）：

:set nu

4. 复制下面代码：

<profile>
    <id>jdk-1.8</id>
    <activation>
        <activeByDefault>true</activeByDefault>
        <jdk>1.8</jdk>
    </activation>
    <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
    </properties>
</profile>

5. 按i进入编辑模式，在第246行末尾换行，将上一步代码按Shift和Insert键粘贴到247行中，效果如下图：

此时我们配好了Maven的全局JDK版本，使用的是JDK 8版本。

6. 复制下面的代码：

这段代码的含义是将Maven下载依赖源更改为国内的阿里云，可以大幅加快下载速度。

<mirror>
    <id>nexus-aliyun</id>
    <mirrorOf>central</mirrorOf>
    <name>Nexus aliyun</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>

7. 在第158行末尾处换行，粘贴上一步代码，效果如下图：

8. 跳转到第55行，创建一个<localRepository></localRepository>标签，并在二者中间填写第一步你创建的Maven依赖路径，效果如下图所示：

9. 至此，Maven配置完成，按Esc键退出编辑模式，按:wq保存并退出。