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! 😄

相关推荐
Carsene21 小时前
第一章:为什么我们需要“类型安全”的 SQL DSL 框架?
java·sql
wyu7296121 小时前
Spring MVC 学习笔记:配置、注解、RESTful、JSON、拦截器、SSM整合、文件上传下载
java
Python私教21 小时前
HermesAgent 终端工具 Windows 兼容性修复实战:两个 Bug 的排查与解决
windows·bug
Mr_pyx21 小时前
Java 注解(Annotation)详解:从基础到 APT 实战
java·数据库·sqlserver
MegaDataFlowers1 天前
调用Service层操作数据
java·开发语言
spencer_tseng1 天前
redis.windows.conf 2026.04.27
windows·redis
user_admin_god1 天前
SSE 流式响应 Chunk 被截断问题的排查与修复
java·人工智能·spring boot·spring·maven·mybatis
我命由我123451 天前
Java 开发 - CountDownLatch 不需要手动关闭
android·java·开发语言·jvm·kotlin·android studio·android-studio
小研说技术1 天前
结构化输出让Agent返回可预测的格式数据
java·人工智能
两年半的个人练习生^_^1 天前
PinYin4j汉字转拼音使用及踩坑
java