最新版 Maven 安装和配置教程（超详细）

冰、三尺

12392人浏览 · 2025-12-16 17:20:49

冰、三尺 · 2025-12-16 17:20:49 发布

一、什么是 Maven？

1. Maven 是干什么的？

Maven 是一个 Java 项目管理和构建工具，主要解决以下问题：

项目依赖管理（Jar 包不用手动下载）
项目构建（编译、测试、打包、发布）
统一项目结构，方便团队协作

一句话总结：
👉 Maven = 项目管理 + 依赖管理 + 构建工具

2. Maven 的核心概念

在开始安装前，先简单了解几个关键词：

名称	说明
POM.xml	Maven 的核心配置文件
坐标	groupId + artifactId + version
仓库	存放 Jar 包的地方
生命周期	clean / compile / test / package / install / deploy

二、安装 Maven 前的准备

1. 必须先安装 JDK

⚠️ Maven 依赖 JDK，必须先安装并配置好 Java 环境

验证 JDK 是否安装成功：

java -version 如果能正常输出版本信息，说明 JDK 没问题。

2. Maven 下载说明

官网地址：https://maven.apache.org/
网盘下载（速度快）: https://pan.baidu.com/s/1RYoiF_u7shviTW4ZHNUhzw?pwd=mynw

⚠️ 注意：

Windows 下载 .zip
macOS / Linux 下载 .tar.gz

三、Windows 安装 Maven（超详细）

1. 解压刚刚下载的zip包：

目录结构说明：

apache-maven-3.9.x
├── bin （可执行命令）
├── boot
├── conf （配置文件 settings.xml）
└── lib

2. 配置环境变量

1.打开刚刚解压完的zip文件：

复制 apache-maven-3.9.8-bin的路径

2.打开环境变量设置：搜索框输入环境→点击编辑系统环境变量→点击环境变量

3.点击新建

变量名

MAVEN_HOME

路径

D:\develop_tool1\apache-maven-3.9.11

双击path，点击新建，输入%MAVEN_HOME%\bin

%MAVEN_HOME%\bin

3. 验证 Maven 是否安装成功

打开 cmd / PowerShell：输入mvn -v

四、Maven 核心配置（重点）

1. 本地仓库配置（强烈推荐）

默认仓库位置：

C:\Users\用户名\.m2\repository

修改为自定义目录，例如：

D:\develop_tool1\apache-maven-3.9.11\repository

在D:\develop_tool1\apache-maven-3.9.11 下找到conf文件夹，打开，找到settings.xml文件：

找到 localRepository 节点，在注释外添加：

<localRepository>D:\develop_tool1\apache-maven-3.9.11\repository</localRepository>

注意，<localRepository>这里填你自己刚刚新建的本地仓库文件路径</localRepository>
如图：

2. 配置国内镜像（必做）

使用 阿里云镜像，大幅提升下载速度：同样的，在之前这个 settings.xml 文件中找到 mirrors 节点

将下面的内容复制粘贴进去：

<!-- 阿里云仓库 -->
<mirror>
	<id>alimaven</id>
	<mirrorOf>central</mirrorOf>
	<name>aliyun maven</name>
	<url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
</mirror>

3. 配置 JDK 版本（推荐）

同样的，在之前这个 settings.xml 文件中找到 profiles 节点：

将下面的内容复制粘贴进去：

<profile>
    <id>jdk-17</id>
    <activation>
        <jdk>17</jdk>
    </activation>
    <properties>
        <maven.compiler.release>17</maven.compiler.release>
    </properties>
</profile>

如图：