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

要在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行附近找到被注释掉的
第四步:保存settings.xml。这一步做完后,Maven不会再往C:\Users\用户名\.m2\repository里写任何东西。
添加阿里云镜像加速依赖下载
方法一:直接在settings.xml中插入镜像配置
在settings.xml文件中找到
注意:2026年起阿里云Maven镜像已强制启用HTTPS,【若仍用http://开头会导致连接拒绝】。
方法二:快速验证镜像是否生效
打开新cmd窗口,执行mvn help:system,观察输出中repository路径是否为E:/maven-repo,同时留意日志里是否有“Downloading from alimaven”字样——有则说明镜像已接管中央仓库请求。











