更改Maven本地仓库路径需修改settings.xml文件,推荐在用户目录下配置;2. 在中添加标签指定新路径;3. 执行mvn help:effective-settings验证配置生效。

安装Maven后,默认的本地仓库位于用户主目录下的 .m2/repository 文件夹中。如果你希望更改这个路径,比如因为磁盘空间不足或想统一管理依赖库,可以通过修改 Maven 的配置文件 settings.xml 来指定新的本地仓库位置。
1. 找到 settings.xml 配置文件
Maven 的配置文件 settings.xml 通常有两个位置:
- Maven 安装目录下:{M2_HOME}/conf/settings.xml(全局配置)
- 用户目录下:{user.home}/.m2/settings.xml(用户级配置,优先级更高)
推荐在用户目录下创建或修改 settings.xml,避免影响其他用户或需要管理员权限。
2. 创建或修改 settings.xml 文件
如果 {user.home}/.m2/ 目录下没有 settings.xml,可以从 Maven 安装目录的 conf/ 中复制一份过来,再进行修改。
3. 修改本地仓库路径
打开 settings.xml 文件,在
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">
将 D:/maven/repo 替换为你想要的路径,例如 E:\mvn_repo 或 /opt/maven/repo(Linux系统)。
4. 验证配置是否生效
打开命令行,执行以下命令:
mvn help:effective-settings查看输出内容中的 localRepository 字段,确认路径是否已更新为你设置的目录。
之后当你运行 mvn compile 或 mvn install 等命令时,依赖包就会下载到你指定的新仓库路径中。
基本上就这些。改本地仓库路径不复杂,关键是改对 settings.xml 文件并确保路径有读写权限。










