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

相关推荐
colicode2 小时前
安卓Android语音验证码接口API示例代码:Kotlin/Java版App验证开发
android·java·前端·前端框架·kotlin·语音识别
Java后端的Ai之路3 小时前
【 Java】-网络协议核心知识问答(比较全)
java·开发语言·网络协议
小道仙979 小时前
jenkins对接、jenkins-rest
java·servlet·jenkins·jenkins-rest
成为你的宁宁9 小时前
Jenkins 自动化部署前后端分离若依项目全攻略:涵盖环境配置、Maven/Node.js 工具安装、GitLab 项目协同,及前后端构建、服务器推送与代码更新验证全步骤
node.js·自动化·gitlab·jenkins·maven
莫寒清10 小时前
MinIO
java
Java后端的Ai之路12 小时前
【JDK】-JDK 21 新特性内容
java·开发语言·后端·jdk·jdk21
黎雁·泠崖14 小时前
Java常用类核心详解(七):正则表达式 Regex 从入门到实战
java·开发语言·正则表达式
水饺编程14 小时前
第4章,[标签 Win32] :TextOut 测试案例3代码改编
c语言·c++·windows·visual studio