当前位置：首页 > news >正文

Maven 安装配置（详细教程）

news 来源：原创 2025/7/1 17:25:45

文章目录

一、Maven 简介
二、下载 Maven
三、配置 Maven
- 3.1 配置环境变量
- 3.2 Maven 配置
- 3.3 IDEA 配置
四、结语

一、Maven 简介

Maven 是一个基于项目对象模型（POM）的项目管理和自动化构建工具。它主要服务于 Java 平台，但也支持其他编程语言。Maven 的核心优势在于其依赖管理和项目构建的自动化，允许开发者通过简单的配置来管理项目的构建、文档生成、报告、依赖、源代码管理、发布和分发等步骤。

二、下载 Maven

进入 Maven 官方网站，找到自己电脑对应系统的 Maven 压缩包版本下载即可，以 Windows 系统为例：

在这里插入图片描述

将下载好的 Maven 压缩包解压，得到下面文件夹：

在这里插入图片描述

进入文件夹，创建 repo 文件夹，用于存放 Maven 本地仓库依赖，将路径复制下来：

三、配置 Maven

3.1 配置环境变量

返回桌面，右键 此电脑 >> 属性 >> 高级系统设置 >> 环境变量，在系统变量模块下新建一个系统变量，具体如下：

在这里插入图片描述

之后在系统变量模块下找到 Path 系统变量，操作如下：

变量值：%MAVEN_HOME%\bin，可以点击上移，改变系统环境变量的加载顺序。

在这里插入图片描述

完成后，输入 Win + R 运行 CMD ，输入 mvn -version（查看 maven 版本），如下所示表示配置成功：。

在这里插入图片描述

提示：如果普通用户不行的话，可以通过管理员的身份打开 CMD。

3.2 Maven 配置

进入 apache-maven-3.9.9 文件夹，进入 config 文件夹，点击 settings.xml 文件。

在这里插入图片描述

（1）配置 Maven 本地仓库依赖的存储位置：

进入 apache-maven-3.9.9 文件夹下的 repo 文件夹，将路径复制下来，然后返回 settings.xml 文件：

在这里插入图片描述

在 settings.xml 的第 56 行，输入下面命令，注意路径每个人都不同：

<localRepository>E:\Maven\apache-maven-3.9.9\repo</localRepository>

在这里插入图片描述

（2）配置阿里云服务器镜像

由于 Maven 的默认服务器在国外所以下载依赖会很慢，所以我们需要将其改为国内的阿里云服务器，一般使用的是阿里云的镜像。

在 settings.xml 的第 160 行，我是打了空格所以会多几行，输入下面命令：

<!-- 阿里云镜像 -->
<mirror><id>aliyunmaven</id><mirrorOf>*</mirrorOf><name>阿里云公共仓库</name><url>https://maven.aliyun.com/repository/public</url>
</mirror>

在这里插入图片描述

（3）配置 JDK 版本

在 Maven 中配置 JDK 版本，可以确保项目在正确的 JDK 环境下进行构建和运行，避免因 JDK 版本不兼容而导致的编译错误或运行时问题。

在 settings.xml 的第 200 行，要根据自己下载的 JDK 配置，我这里以 JDK 17 和 JDK 8 为例，输入下面命令：

JDK 17

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

在这里插入图片描述

JDK 1.8

<!-- JDK1.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>

在这里插入图片描述

（4）完整的 settings.xml

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd"><!-- 本地依赖存放位置 --><localRepository>E:\Maven\apache-maven-3.9.9\repo</localRepository><mirrors><!-- 阿里云镜像 --><mirror><id>aliyunmaven</id><mirrorOf>*</mirrorOf><name>阿里云公共仓库</name><url>https://maven.aliyun.com/repository/public</url></mirror></mirrors><profiles><!-- JDK17 --><profile><id>jdk-17</id><activation><activeByDefault>true</activeByDefault><jdk>17</jdk></activation><properties><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target><maven.compiler.compilerVersion>17</maven.compiler.compilerVersion></properties></profile></profiles>
</settings>

注意：操作完后，记得保存 settings.xml 文件。

（5）检查是否配置成功

输入 Win + R 运行 CMD ，输入 mvn help:system（打印 Maven 信息），如下所示表示配置成功：

在这里插入图片描述

3.3 IDEA 配置

打开 IDEA，在登录界面，依次点击 Customize >> All settings...

在这里插入图片描述

在左上角输入 Maven，找到这个，按照自己的情况配置：

在这里插入图片描述

配置好后点击 Apply，最后点击 OK，即可。

四、结语

这篇文章大概 4500 字，所以阅读起来还是需要一定的时间，不要心急，我是把自己的 Maven 删除后，跟着文章重新配置了的，在配置 Maven 那一块，需要细心一点，如果有什么问题，欢迎在评论区中评论。

至此，本文结束，如果这篇文章对您有所帮助，希望可以点赞、收藏加关注，感谢。

请添加图片描述

文章目录

一、Maven 简介

二、下载 Maven

三、配置 Maven

3.1 配置环境变量

3.2 Maven 配置

3.3 IDEA 配置

四、结语

相关文章：