Maven 安装配置（完整教程）

news2025/3/17 11:58:08

文章目录

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