Maven安装配置全解析:环境变量与本地仓库设置【实操干货】

絕刀狂花

絕刀狂花

2026-08-05

775人浏览

原创

必须配置maven_home与path环境变量并重定向本地仓库路径,才能使mvn命令全局可用且避免依赖占用c盘;需解压maven至无中文无空格路径,检查bin/conf/lib目录完整,修改settings.xml中localrepository指向自定义路径,并配置阿里云https镜像。

maven安装配置全解析:环境变量与本地仓库设置【实操干货】 - php中文网

要在Windows系统上让Maven命令在任意位置都能执行,并确保依赖包不默认堆满C盘用户目录,必须完成环境变量配置和本地仓库路径重定向两件事——缺一不可,否则新建项目时会卡在依赖下载或报“mvn不是内部命令”。

解压Maven并确认目录结构

Maven官网下载apache-maven-3.9.9-bin.zip(截至2026年8月最新稳定版),解压到无中文、无空格的路径,例如D:\software\maven\apache-maven-3.9.9。解压后立即检查根目录是否存在bin、conf、lib三个核心文件夹——【若缺少conf文件夹,说明解压不完整,需重新解压】

配置MAVEN_HOME与Path环境变量

右键“此电脑”→属性→高级系统设置→环境变量→系统变量区域点击“新建”:

变量名填MAVEN_HOME,变量值填你刚才解压的完整路径,例如D:\software\maven\apache-maven-3.9.9。

再在系统变量中找到Path,点击编辑→新建→输入%MAVEN_HOME%\bin。

【必须关闭所有已打开的cmd窗口,再新开一个,否则mvn命令无法识别】

修改本地仓库路径(避开C盘)

第一步:在D盘或E盘新建一个空文件夹,例如E:\maven-repo,不要用中文名,也不要带空格。

第二步:进入Maven解压目录下的conf文件夹,用VS Code或记事本打开settings.xml。

第三步:按下Ctrl+F搜索localRepository,在第53行附近找到被注释掉的标签段落,取消注释,并把路径改成你刚创建的文件夹绝对路径,注意用正斜杠/而非反斜杠\:

PHP基础-环境变量函数等
PHP基础-环境变量函数等

PHP基础-环境变量函数等 vip-kj-zhu/php-kj/4-jQuery-最流行的JS函数库.zip

下载

E:/maven-repo

第四步:保存settings.xml。这一步做完后,Maven不会再往C:\Users\用户名\.m2\repository里写任何东西。

添加阿里云镜像加速依赖下载

方法一:直接在settings.xml中插入镜像配置

在settings.xml文件中找到标签对(通常在第148行左右),在其中插入以下代码:


  alimaven
  aliyun maven
  https://maven.aliyun.com/nexus/content/groups/public/
  central

注意:2026年起阿里云Maven镜像已强制启用HTTPS,【若仍用http://开头会导致连接拒绝】

方法二:快速验证镜像是否生效

打开新cmd窗口,执行mvn help:system,观察输出中repository路径是否为E:/maven-repo,同时留意日志里是否有“Downloading from alimaven”字样——有则说明镜像已接管中央仓库请求。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

2025.09.15

1020

19

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

2026.05.09

183

25

PyCharm安装配置教程合集
PyCharm安装配置教程合集

本专题汇总了PyCharm的完整安装部署与配置教程,涵盖从官网下载到Windows/Mac/Linux各平台安装包的选择与安装过程、环境变量配置及虚拟环境创建。同时整理了PIP镜像源更换、必要插件推荐、界面汉化等优化技巧,并附快捷键使用指南,助你快速搭建高效Python开发环境。

2026.08.05

0

19

Qt Creator编译运行使用教程
Qt Creator编译运行使用教程

围绕 Qt Creator 编译、运行、构建错误、断点调试、变量查看、调用栈、Debug与Release切换、编译输出和运行日志展开,帮助用户处理程序无法运行、断点不生效、找不到库文件、构建失败等问题。

2026.08.05

2

10

Qt Creator按钮响应设置方法
Qt Creator按钮响应设置方法

信号槽是 Qt 开发的核心机制。本专题整理 Qt Creator 中按钮点击、菜单触发、输入变化、窗口事件、自定义信号、自动连接槽函数和手动 connect 写法,帮助用户理解界面控件如何和 C++ 代码联动。

2026.08.05

0

10

Qt Creator新建项目使用教程
Qt Creator新建项目使用教程

本专题整理 Qt Creator 新建项目、打开已有工程、项目模板选择、目录结构、源文件管理、构建目录、运行配置和项目迁移方法,重点解决新手不知道选 qmake 还是 CMake、项目打不开、文件不参与编译等常见问题。

2026.08.05

0

10

maven常用插件使用大全
maven常用插件使用大全

PHP中文网精心整理Maven主流插件用法合集,涵盖编译、测试、打包等常用插件使用大全。从基础配置到进阶实战,详细解析各插件功能与适用场景,助你轻松掌握Maven自动化构建,解决Java项目开发痛点,是开发者必备的实用指南。

2026.08.05

0

31

PyCharm快速入门指南
PyCharm快速入门指南

本专题汇总了PyCharm快速入门的全套指南与教程,涵盖从官网下载安装、创建第一个Python项目、配置虚拟环境,到代码编辑、运行调试等基础操作,并整理了版本控制(Git)集成、常用高效快捷键及实用插件等进阶技巧,助你快速上手这款高效的Python IDE。

2026.08.05

2

17

PyCharm运行程序教程大全
PyCharm运行程序教程大全

本专题汇总了PyCharm运行程序的多种方式与详细操作步骤,涵盖通过主菜单Run、点击工具栏绿色三角图标、使用快捷键Shift+F10(或Ctrl+Shift+F10)等基本运行方法,以及配置运行/调试参数、设置PYTHONPATH环境变量、管理多脚本运行与交互式Python控制台调试等进阶技巧,助您全面掌握在PyCharm中高效运行与管理Python程序的方法。

2026.08.05

0

14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP基础-环境/变量/函数等
PHP基础-环境/变量/函数等

共57课时 | 17.5万人学习