返回 导航

其他

hangge.com

Java - Windows下Maven的安装、配置教程（配置本地仓库路径、阿里云镜像加速）

作者：hangge | 2026-06-04 08:49
    我之前写过 macOS 下 Maven 的安装和配置教程（点击查看），本文接着演示如何在 Windows 10/11 系统下安装、配置 Maven，包含环境准备、环境变量配置、本地仓库配置、阿里云镜像加速等操作。

1，安装 JDK

    Maven 是 Java 项目构建工具，必须先安装配置 JDK（JDK8 及以上版本均可），否则 Maven 无法运行。具体安装方法可以参考我之前写的文章：

2，下载 Maven 安装包

（1）访问 Maven 官网（点击访问），在页面中找到 Binary zip archive 格式压缩包（Windows 专用免安装压缩包），点击下载即可。
提示：推荐下载稳定版 3.9.x 系列，兼容性最强，避免最新版兼容问题。

（2）将下载的 apache-maven-xxx-bin.zip 压缩包解压到自定义目录，比如我这里解压到 E 盘根目录下。
注意：解压路径不能包含中文、空格、特殊字符，避免后续报错。

3，配置 Maven 环境变量

（1）配置环境变量目的是让系统任意目录下都能识别 mvn 命令，全局运行 Maven。右键「此电脑」→ 选择「属性」→ 点击「高级系统设置」→ 右下角「环境变量」

（2）在“系统变量”区域点击“新建”，填写如下内容，然后点击“确定”保存。
  • 变量名：MAVEN_HOME
  • 变量值：Maven 解压后的根目录

（3）在系统变量列表中找到 Path 变量，选中后点击“编辑”。接着在弹框中点击“新建”，添加变量值：%MAVEN_HOME%\bin 最后依次点击所有窗口的“确定”，保存全部配置。

（4）我们可以在 CMD 窗口中执行如下命令验证 Maven 是否安装成功。
mvn -version

4，配置本地仓库+阿里云镜像

（1）默认 Maven 仓库在 C 盘，会占用系统盘空间。我们在非系统盘新建文件夹，作为 Maven 依赖包存储仓库，例如：E:\maven-repository（路径同样无中文、无空格）。

（2）打开 Maven 目录下的配置文件：conf\settings.xml，在文件中找到 <localRepository> 标签（默认被注释），复制以下代码，替换并填写自己的仓库路径，放在 <settings> 标签内。
<!-- 配置Maven本地仓库路径 -->
<localRepository>E:\maven-repository</localRepository>

（3）默认官方镜像下载速度极慢，我们找到 settings.xml 文件中的 <mirrors> 标签，在标签内添加阿里云镜像配置，替换默认国外镜像，可以大幅提升依赖下载速度。 
<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>central</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

（4）配置完成后，保存 settings.xml 文件。要验证配置是否生效，可以重新打开 CMD，输入如下命令会自动下载基础依赖包，等待执行完毕。
mvn help:system

（5）打开之前创建的本地仓库文件夹 E:\maven-repository，若出现大量缓存文件，说明仓库和镜像配置完全生效。
评论

全部评论（0）

回到顶部