第 0 章 工具安装｜第二节：Maven 安装 + IDEA 配置 Maven（阿里云镜像）

第 0 章 工具安装｜第二节：Maven 安装 + IDEA 配置 Maven（阿里云镜像）

目标：安装 Maven，配置本地仓库、阿里云镜像，在 IDEA 里绑定 Maven，解决依赖下载慢、拉不下来的问题
版本选择：Maven 3.9.6（适配 SpringBoot3，稳定，不选 4.x，兼容性问题多）

1. 下载 Maven

官网地址：https://archive.apache.org/dist/maven/maven-3/3.9.6/binaries/
下载：apache-maven-3.9.6-bin.zip（Windows 用压缩包，Maven 没有 msi 安装包，都是绿色解压版）

✅ 解压要求：
解压路径不能有中文、空格、特殊符号
推荐路径：D:\apache-maven-3.9.6

2. 配置 Maven 系统环境变量

1. 此电脑右键 → 属性 → 高级系统设置 → 环境变量
2. 在【系统变量】新建：
   变量名：MAVEN_HOME
   变量值：D:\apache-maven-3.9.6 （你的解压根目录，到这一层，不要到 bin）
3. 找到系统变量 Path → 编辑 → 新增一行：
   %MAVEN_HOME%\bin
4. 全部窗口点确定保存，关闭所有旧 cmd 窗口

验证 Maven 环境变量

新开 cmd，执行命令：

mvn -v

✅ 成功标准：
输出 Maven 版本、Java 版本（显示 JDK17）、本地仓库默认地址

常见失败：提示不是内部命令 → 检查环境变量、路径拼写、是否重开 cmd

3. 配置 Maven 核心配置文件 settings.xml

文件位置：D:\apache-maven-3.9.6\conf\settings.xml

先新建本地仓库文件夹：推荐 D:\maven-repository（放所有下载的 jar 包）

① 修改本地仓库路径

找到 settings 里的 <localRepository> 标签，默认是注释掉的，改成：

<localRepository>D:\maven-repository</localRepository>

放在 <settings> 标签内部最上方。

② 配置阿里云镜像（重中之重，解决下载慢）

找到 <mirrors> 标签，把里面原有内容清空，粘贴下面阿里云镜像：

<mirrors>
    <!-- 阿里云maven镜像 -->
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

保存 settings.xml

4. IDEA 中配置 Maven

打开 IDEA（先不要新建项目，先打开设置）

• Win：File → Settings 快捷键 Ctrl+Alt+S
• Mac：IntelliJ IDEA → Settings

找到：Build, Execution, Deployment → Build Tools → Maven
修改 3 处配置：

1. Maven home path：选择 D:\apache-maven-3.9.6（我们刚解压的 maven）
2. User settings file：勾选 Override，选中 D:\apache-maven-3.9.6\conf\settings.xml
3. Local repository：自动读取成 D:\maven-repository，确认路径正确

补充：下面的 Runner 里面，JRE 选择我们装好的 JDK17（不要选 IDEA 自带的）
勾选：Import Maven projects automatically 自动导入依赖

点击 Apply → OK 保存

【本节测试任务】

1. cmd 执行 mvn -v，确认输出版本正常，绑定 JDK17
2. IDEA 打开 Maven 设置页面，核对上面三项路径是否正确
   

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/qq_36158551/article/details/169459732