必须修改Maven本地仓库路径并配置环境变量:先解压到非中文无空格路径,设置MAVEN_HOME和Path;再在用户级settings.xml中添加D:\maven-repo,最后用mvn compile验证依赖是否下载至新路径。

想把Maven下载的依赖包从默认C盘挪到D盘或E盘,避免系统盘越用越满、编译卡顿甚至磁盘爆满报错,必须手动改本地仓库路径并确保环境变量指向正确安装目录。
配置MAVEN_HOME和Path环境变量
第一步:解压Maven压缩包到非中文、无空格路径,例如 【D:\develop_tools\apache-maven-3.9.10】。路径含中文或空格会导致mvn命令执行失败,且后续IDEA识别也会出问题。
第二步:右键“此电脑”→“属性”→“高级系统设置”→“环境变量”,在“系统变量”区点击“新建”,变量名填 【MAVEN_HOME】,变量值填你刚解压的完整路径(不含bin)。
第三步:在“系统变量”中找到Path,点击“编辑”→“新建”,输入 【%MAVEN_HOME%\bin】。注意不要漏掉%符号,也不要手动拼写路径——用变量引用才可靠。
第四步:打开新命令提示符(不是之前已打开的旧窗口),输入 【mvn -v】。看到Apache Maven版本号、Java版本和Maven主目录路径,说明环境变量生效。
修改settings.xml指定本地仓库位置
方法一:直接编辑Maven自带配置文件
打开 【D:\develop_tools\apache-maven-3.9.10\conf\settings.xml】,用记事本或VS Code打开(别用Word)。
按下Ctrl+F搜索 【localRepository】,找到被注释掉的那行示例代码:<!-- <localRepository>/path/to/local/repo</localRepository> -->。
删掉前后<!--和-->,把中间路径替换成你想要的新仓库地址,比如 【D:\maven-repo】。这行必须顶格写,不能缩进,否则Maven会忽略。
方法二:优先使用用户级配置(推荐)
进入当前Windows用户目录:【C:\Users\你的用户名\.m2】。如果该文件夹不存在,手动新建一个名为 【.m2】 的文件夹(注意开头的点)。
把 【D:\develop_tools\apache-maven-3.9.10\conf\settings.xml】 复制一份,粘贴进 【C:\Users\你的用户名\.m2】 文件夹,并重命名为 【settings.xml】。
编辑这个用户级settings.xml,在 <settings></settings> 标签下直接添加一行:<localrepository>D:\maven-repo</localrepository>。用户级配置优先级高于全局conf下的配置,且不会被Maven升级覆盖。
验证本地仓库路径是否生效
在任意空文件夹下新建一个pom.xml,内容只需包含最简结构:<project xmlns="http://maven.apache.org/POM/4.0.0"><modelversion>4.0.0</modelversion><groupid>test</groupid><artifactid>demo</artifactid><version>1.0</version></project>。
命令行进入该文件夹,执行 【mvn compile】。Maven会自动下载maven-core、plexus-utils等基础依赖。
立刻去你设置的路径(如D:\maven-repo)查看,应该能看到按groupId分层创建的文件夹,例如 【D:\maven-repo\org\apache\maven\maven-core】。如果该路径下始终为空,说明配置未生效,重点检查settings.xml是否放对位置、

















