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

Maven 安装配置（完整教程）

news 2025/6/28 15:25:44

文章目录

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

如果嫌麻烦可以直接将 settings.xml 文件的内容完全更换为下面我准备好的的内容：

注意：本地路径要看自己的情况配置，JDK 的话更改其版本的数字就可以了。

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