Windows 安装 Maven 详细教程(含镜像与本地仓库配置)

大家好,本篇将为大家带来一份详尽的 Maven 安装与配置实战教程,专为 Windows 用户量身编写。无论你是刚入门的 Java 新手,还是有一定经验的开发者,跟着本文一步步操作,都能顺利完成 Maven 的安装与配置。

文章目录

一、安装前准备

检查 Java 环境

Maven 是基于 Java 运行的构建工具,因此在开始之前,需要确认系统中已安装 Java 并正确配置了环境变量。

打开命令提示符(CMD),执行以下命令来检测 Java 是否可用:

bash 复制代码
java -version

若终端输出版本号,说明 Java 已就绪;若提示不是内部或外部命令 ,则需要先完成 Java 的安装。

安装 Java(如果尚未安装)

Java 的安装步骤可参考我此前发布的博客:Java 安装保姆级教程


二、下载 Maven

前往 Maven 官方下载页面:Maven 官方下载页面

在下载列表中,选择 Binary zip archive (二进制 zip 压缩包),例如:apache-maven-3.9.11-bin.zip


三、安装 Maven

第一步:解压 Maven 压缩包

将下载好的 zip 文件解压至一个不含中文字符和空格 的目录下,例如:C:\apache-maven-3.9.11,具体路径可根据个人习惯自行指定。

注意:路径中请勿包含中文或空格,否则可能引发不可预期的问题

第二步:配置环境变量

打开 Windows 设置,搜索"环境变量",点击"编辑系统环境变量"

在"系统变量"区域,点击"新建"按钮

按如下填写新建变量:

  • 变量名:MAVEN_HOME
  • 变量值:Maven 的解压路径,如 C:\apache-maven-3.9.11

注意:请确认该目录下存在 bin 文件夹

在系统变量列表中找到 Path ,点击"编辑"

点击"新建",输入 %MAVEN_HOME%\bin,依次点击"确定"保存全部设置

第三步:验证安装结果

重新打开一个命令提示符窗口,输入以下命令:mvn -version

若终端正常输出 Maven 版本信息,则说明安装配置已全部成功 🎉


四、配置 Maven 镜像

为了显著提升依赖包的下载速度,强烈推荐将镜像源切换为国内节点。

  1. 找到 Maven 安装目录下的 conf/settings.xml 文件(例如:C:\apache-maven-3.9.11\conf\settings.xml

  2. 使用任意文本编辑器(记事本、VS Code 等)将其打开

  3. 定位到 <mirrors> 标签

  4. <mirrors> 标签内部添加以下配置:

xml 复制代码
    <mirror>
      <id>nexus-aliyun</id>
      <mirrorOf>central</mirrorOf>
      <name>Nexus aliyun</name>
      <url>http://maven.aliyun.com/nexus/content/groups/public</url>
    </mirror>

完成配置后,Maven 将优先从阿里云镜像节点拉取依赖,下载速度将得到明显改善。


五、配置本地仓库

  1. 继续打开 settings.xml 文件
  2. <mirrors> 标签上方新增以下配置:

<localRepository>C:\apache-maven-3.9.11\repository</localRepository>

说明:C:\apache-maven-3.9.11\repository 为自定义的本地仓库存放路径。例如,若你在 D 盘新建了一个名为 repository 的文件夹作为仓库目录,则 <localRepository> 标签中应填写 D:\repository


总结

按照本教程操作完成后,你的 Windows 系统上已成功完成 Maven 的安装与全套配置。Maven 是 Java 生态中不可或缺的项目构建利器,熟练掌握它将大幅提升日常开发效率。随着项目实践的深入,你会逐渐体会到 Maven 在依赖管理和工程构建方面带来的便利。

希望本篇教程能对你有所帮助!安装或使用过程中若遇到任何疑问,欢迎在评论区留言,一起交流探讨。

祝编程顺利,代码无 bug! 😄

相关推荐
美好的事情能不能发生在我身上20 小时前
Hot100中的:贪心专题
java·数据结构·算法
myloveasuka20 小时前
Java与C++多态访问成员变量/方法 对比
java·开发语言·c++
Andya_net20 小时前
Spring | @EventListener事件机制深度解析
java·后端·spring
lang2015092821 小时前
18 Byte Buddy 进阶指南:解锁 `@Pipe` 注解,实现灵活的方法转发
java·byte buddy
重庆小透明21 小时前
【java基础篇】详解BigDecimal
java·开发语言
杰克尼1 天前
苍穹外卖--day08
java·数据库·spring boot·mybatis·notepad++
lierenvip1 天前
SQL 建表语句详解
java·数据库·sql
kuntli1 天前
Spring Bean生命周期全解析
java
ok_hahaha1 天前
java从头开始-苍穹外卖-day06-微信小程序开发-微信登录和商品浏览
java·微信·微信小程序·小程序
Java面试题总结1 天前
Spring @Validated失效?原因、排查与高效解决方案全解析
java·spring boot·spring