史上最详细的Maven安装教程

article/2025/9/20 22:29:08

熟练的配置开发环境是每一个程序员必备的功课，俗话说：工欲善其事，必先利其器。

本文须知：安装maven环境之前要先安装java jdk环境（没有安装java环境的可以先去看安装JAVA环境的教程）Maven 3.3+ require JDK 1.7 及以上。

第一步：下载maven（本教程安装的是3.8.4）

官方下载链接：https://maven.apache.org/download.cgi

Binary是可执行版本，已经编译好可以直接使用。
Source是源代码版本，需要自己编译成可执行软件才可使用。

如果下载不成功可以在以下百度云盘获取：

链接：https://pan.baidu.com/s/1S_V2sCw7MaH3cRiJPH489w

提取码：cx66

我们选择已经编译好的windows版本进行安装：选择zip版本(linux选择tar.gz)

如下图：

下载成功的文件：

下载完成后进行解压到自己要安装的路径(为避免安装失败建议路径和我的保持一致)：

第二步maven环境配置（点击此电脑右键属性）：

点击高级系统设置，点击环境变量：

开始配置环境变量（点击系统变量，新建按钮）：

新建系统变量：MAVEN_HOME=D:\maven\apache-maven-3.8.4(以自己安装的路径为准)

编辑变量Path：

添加变量值： %MAVEN_HOME%\bin

依此点击确定关闭窗口（注不要直接关闭按钮要不然配置不生效得重配置）

第三步验证maven环境配置是否成功（按住win+R 输出cmd弹出命令行窗口(dos窗口)）：

输入命令：mvn -version

MAVEN安装成功：

第四步接下来要配置maven仓库以及相关设置：

1.在maven同级目录下建一个maven仓库

2. 在路径D:\maven\apache-maven-3.8.4\conf(自己安装的路径)下找到settings.xml文件

1.找到节点localRepository，在注释外添加自己仓库的地址

3.配置镜像（采用国内阿里云的镜像下载依赖会快很多）

1在settings.xml配置文件中找到mirrors节点

2. 添加如下配置（注意要添加在<mirrors>和</mirrors>两个标签之间，其它配置同理）,放在默认节点的前面。

<mirror>

<id>alimaven</id>

<mirrorOf>central</mirrorOf>

<name>aliyun maven</name>

<url>http://maven.aliyun.com/nexus/content/repositories/central/</url>

</mirror>

4.配置JDK

在settings.xml配置文件中找到profiles节点

添加如下配置

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

到此，配置完成。win+R运行cmd，输入命令：mvn help:system测试，配置成功则本地仓库如下图显示。

首次执行 mvn help:system 命令，Maven相关工具自动帮我们到Maven中央仓库下载缺省的或者Maven中央仓库更新的各种配置文件和类库（jar包)到Maven本地仓库中。

下载完各种文件后， mvn help:system 命令会打印出所有的Java系统属性和环境变量，这些信息对我们日常的编程工作很有帮助。

本文的配置文件也会放在百度云盘中，只要修改你的仓库地址该项就可以正常的运行。

补充知识点(添加maven到我们的IDEA中)：

本地的Maven文件一般是配套IDEA一起使用,如何让每一次新建项目都选中自己的maven,本文推荐以下方案解决（避免每一次都要手动修改maven配置）：