【2026 手把手零基础搞定 Maven】Maven下载安装、配置环境变量、本地仓库、镜像加速全流程保姆级教学
目录一Maven 简介二下载安装1、下载2、解压三配置1、配置环境变量2、配置本地仓库3、配置镜像4、验证四卸载1、删除本地仓库2、删除 maven3、找不到的情况4、删除环境变量五常见问题一Maven 简介Maven说明是什么一个帮 Java 项目自动下载依赖库、统一代码结构并一键完成编译、测试和打包的构建工具作用1.依赖管理自动下载并管理第三方库及其传递依赖。2.项目构建统一编译、测试、打包、部署等流程如 jar/war。3.多模块项目支持便于大型项目的分模块开发与聚合构建。4.标准化项目结构提升团队协作效率和项目可维护性。优点1.中央仓库生态连接 Maven Central海量开源库一键引入。2.依赖传递与版本冲突处理自动解析依赖树减少手动管理成本。3.生命周期与插件机制提供 clean、compile、test、package 等标准阶段可扩展插件定制行为。4.跨平台 IDE 友好被主流 IDE如 IntelliJ IDEA、Eclipse深度集成支持 CI/CD 工具链。二下载安装确保电脑已经安装了jdk并且配置了java环境如果需要配置 jdk 可参考以下我的另一篇文章【2026最新附图文】JDK25 下载、配置、卸载 保姆级教学全程附实操步骤图_jdk25如何卸载-CSDN博客1、下载进入官网下载Download Apache Maven – Maven这里我下载的是3.9.16截止发文时最新稳定版注如果遇到下载慢或下载失败的可以参考这一篇文章使用Motrix下载器【告别限速2026最新免费下载神器下载即用】Motrix 下载神器全攻略 超详细图文指南保姆级教学-CSDN博客这些不同安装包也有区别参考下表文件名类型适用人群bin.tar.gz二进制包Linux/macOS 用户bin.zip二进制包Windows 用户src.tar.gz源码包开发者、研究者src.zip源码包开发者、研究者要历史版本可以点击这里Apache Archive Distribution Directory选择版本后点击进入该文件夹再点击 binaries/ 即可选择下载2、解压打开压缩包然后选中这整个文件夹点击“解压到”这是 WinRAR 解压其他的也差不多解压到指定路径自己设置就行不用和我一样注建议路径纯英文且自己能找到硬盘内存足够建议把maven和等会要配置的本地仓库放近点以防找不到解压后目录如下三配置1、配置环境变量按下WIn R在窗口中输入sysdm.cpl按Enter在打开的「系统属性」窗口中点击顶部的“高级”选项卡再点击底部的“环境变量…”按钮点击“新建”输入变量名MAVEN_HOME再点击“浏览目录”找到刚刚解压到的 maven 所在路径点击“确定”然后点击“确定”然后下滑找到“Path”双击点开点击“新建”输入%MAVEN_HOME%\bin点击“确定”验证一下按Win R输入cmd按Enter打开命令行输入mvn -version同mvn -v按Enter查看输出是否有版本号如果输出 mvn 不是内部或外部命令...”等内容则是环境变量配置有误请检测以上步骤是否正确完成2、配置本地仓库先创建本地仓库在maven安装路径里新建文件夹命名为MAVEN_local_repository建议路径纯英文文件夹可以自定义名称在Maven的安装目录里进入conf文件夹在它里面找到setting.xml打开它在打开的xml文件里按 Ctrl F输入localRepository点击查找找到如图所示的地方将如图所示的路径选中替换为刚才创建的本地仓库的路径完成配置本地仓库3、配置镜像同样在此文件中Ctrl F,查找maven-default在他的上方插入以下内容!-- 阿里云仓库 --mirroridalimaven/idmirrorOfcentral/mirrorOfnamealiyun maven/nameurlhttp://maven.aliyun.com/nexus/content/repositories/central//url/mirror4、验证同上打开cmd输入以下内容mvn help:system出现BUILD SUCCESS即配置成功四卸载1、删除本地仓库根据之前的配置的本地仓库的位置删除即可若没有配置则默认在C:\Users\用户名\.m2\repository路径下将名为repository的文件夹删除即可删除repository文件夹2、删除maven找到本地的maven目录直接删除整个文件夹3、找不到的情况如果忘记maven的安装位置或配置的本地仓库的位置按WInR输入cmd按Enter打开命令行打开命令行后输入以下命令运行按Enter运行mvn -v输出 maven 信息包括安装位置mvn help:evaluate -Dexpressionsettings.localRepository -q -DforceStdou输出 maven 本地仓库位置再根据输出的路径去找到删除就行4、删除环境变量按下WIn R在窗口中输入sysdm.cpl按Enter在打开的「系统属性」窗口中点击顶部的“高级”选项卡再点击底部的“环境变量…”按钮在系统变量这一栏下滑找到环境变量MAVEN_HOME删除再找到”path“双击打开再找到添加的 “%MAVEN_HOME%\bin” 删除然后点击 “确定”后面的窗口全部点“确定”即可完成删除五常见问题序号问题可能原因解决方案1mvn 不是内部或外部命令...-MAVEN_HOME未设置或路径错误-%MAVEN_HOME%\bin未加入Path- 环境变量未生效未重启 CMD- 检查MAVEN_HOME是否指向 Maven 解压根目录- 确保Path中包含%MAVEN_HOME%\bin- 关闭并重新打开命令行窗口- 在 CMD 中运行echo %MAVEN_HOME%验证2环境变量配置后仍无效尤其 Win10/11- 变量配置在“用户变量”而非“系统变量”- 权限或 Shell 缓存问题- 将MAVEN_HOME和Path条目配置在系统变量中- 以管理员身份运行 CMD 或 PowerShell必要时3依赖仍下载到默认.m2/repository本地仓库未生效- 实际使用的是用户目录下的~/.m2/settings.xml- 路径含中文/空格- XML 格式错误或标签未正确闭合- 将修改后的settings.xml复制到C:\Users\用户名\.m2\- 使用纯英文路径- 用代码编辑器检查 XML 合法性- 确保localRepository标签完整4配置镜像后下载仍慢 / 报 403 / 连接失败- 使用了已停服的阿里云旧镜像- 公司网络限制或代理未配置- 改用华为云或腾讯云镜像- 如有代理需在settings.xml中配置proxies5mvn -v报错No Java runtime / JAVA_HOME not set- 未安装 JDK- 未配置JAVA_HOME环境变量- 安装 JDK 11 或 17- 设置系统变量JAVA_HOME指向 JDK 根目录- 验证java -version应正常输出6mvn archetype:generate卡住或超时- 首次构建需下载大量插件- 镜像未生效访问国外仓库慢- 确认镜像配置正确- 等待首次下载完成- 可加-X查看详细日志mvn -X archetype:generate7IDEA / Eclipse 无法识别自定义 Maven 配置- IDE 使用内置 Maven- 未指定自定义settings.xml- 在 IDE 设置中手动指定Maven home directory→ 你的 Maven 解压路径User settings file→ 你修改的settings.xml- 勾选 “Override” 选项结尾希望对大家有帮助