Maven安装配置教程（Linux通用版）

本文最后更新于：2025年4月13日

一、安装前检查（Linux端）

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

2. 已经安装JDK的小伙伴，请在命令行执行如下命令，如果出现下图的版本信息，就说明JDK环境变量配置成功：

1	`java -version`

二、下载Maven安装包（Windows端）

以下两种下载Maven安装包方式二选一：

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

点击右侧链接，进入下载界面：点我下载，密码1024

方式二：官网下载（不推荐，下载速度较慢）

1. 点击进入官网下载链接：点我进入

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

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

3. 选择.tar.gz结尾的安装包下载：

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

1. 将前面下载好的Maven安装包使用SFTP工具（这里我使用的是Eleterm）由Windows端传输到Linux端（请先确保Windows本身已经通过SSH方式连接到Linux）：

2. 在左侧Windows端找到下载好的安装包：

3. 在右侧Linux端设置安装包存放路径，这里我将安装包存放在/opt下：

4. 按照下图所示操作，将Maven安装包传到Linux端的/opt目录下：

5. 等待一段时间后，此时Linux端的/opt目录下已经存放了刚才我们传输的文件：

6. 此时我们切换回命令行，执行如下命令切换到/opt目录下：

cd /opt

7. 解压刚刚传输过来的安装包，执行如下命令：

1	`tar -zxvf apache-maven-3.6.3-bin.tar.gz`

小技巧：在命令行中输入文件名时，我们可以只写文件的前一部分，然后按一下Tab键补齐文件名。

8. 等待一段时间后，解压完成，执行如下命令，进入解压后的文件夹名称：

ls

使用cd命令进入解压后的文件夹：

1	`cd apache-maven-3.6.3/`

9. 输入如下命令，查看当前文件路径：

pwd

10. 复制如下代码：

#MAVEN_HOME  
MAVEN_HOME=/opt/apache-maven-3.6.3
PATH=$PATH:$MAVEN_HOME/bin
export PATH MAVEN_HOME

11. 在/etc/profile.d目录下创建maven_env.sh文件，执行如下命令：

1	`vim /etc/profile.d/maven_env.sh`

没有vim根据自己的操作系统执行如下命令安装：

CentOS
1
sudo yum -y install vim
Ubuntu/Debian
1
sudo apt -y install vim

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

13. 将光标移动到第二行，将MAVEN_HOME对应的值替换成第9步复制的路径。完成后按一下Esc键，然后输入:wq保存并退出。

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

1	`source /etc/profile.d/maven_env.sh`

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

mvn -v

四、配置Maven

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

1. 找一个你熟悉的位置存放Maven依赖，这里我创建一个目录专门存放Maven依赖：

1	`mkdir -p /home/maven/repository`

2. 进入Maven安装目录：

1	`cd /opt/apache-maven-3.6.3/`

3. 执行如下命令，查看当前目录下的所有文件和文件夹：

ls

4. 进入conf文件夹，执行如下命令：

1	`cd conf/`

5. 再次执行ls命令，可以看到里面有一个settings.xml文件，这个文件就是我们后续需要修改的配置文件：

6. 使用vim命令编辑settings.xml：

1	`vim settings.xml`

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

:set nu

8. 复制下面代码：

<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>

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

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

10. 复制下面的代码：

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

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