maven

一、Maven 配置前的前提

Maven 是基于 Java 的构建工具，配置前必须确保：

已安装并配置好 JDK（8/17 均可），且 java -version 能正常输出版本信息。
安装路径不要包含中文、空格或特殊字符（如 D:\maven 可行，D:\软件\maven 3.9 不可行）。

二、Maven 下载与安装

步骤 1：下载 Maven

访问 Maven 官方下载地址：https://maven.apache.org/download.cgi
下滑找到「Files」区域，选择「Binary zip archive」（Windows 系统），下载最新稳定版（如
1

apache-maven-3.9.6-bin.zip
）。
- 避免下载「Source archive」（源码包），只需要二进制包。

步骤 2：解压安装

将下载的 zip 包解压到指定目录（如 D:\apache-maven-3.9.6）。

1
2
3
4
5


apache-maven-3.9.6/
├── bin/          # 存放 mvn 可执行命令（mvn.cmd、mvn.bat）
├── conf/         # 核心配置文件 settings.xml（重点修改）
├── lib/          # Maven 依赖库（无需修改）
└── LICENSE       # 说明文件（可忽略）

三、配置系统环境变量（Windows 为例）

这一步是让系统能全局识别 mvn 命令，步骤如下：

步骤 1：打开环境变量配置界面

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
切换到「系统变量」区域（区别于「用户变量」，全局生效）。

步骤 2：新建 MAVEN_HOME 变量

点击「新建」，输入：
- 变量名：MAVEN_HOME
- 变量值：Maven 解压根路径（如 D:\apache-maven-3.9.6）
- 点击「确定」。

步骤 3：配置 Path 变量

在「系统变量」中找到 Path 变量，点击「编辑」。
点击「新建」，输入：%MAVEN_HOME%\bin。
点击「上移」将该条目置顶（避免冲突），依次点击「确定」保存所有配置。

步骤 4：验证环境变量

关闭所有已打开的 cmd 窗口（避免缓存），重新打开 cmd。
执行命令：mvn -v（注意是小写 v）。

输出如下内容说明配置成功：

1
2
3
4
5


Apache Maven 3.9.6 (bc0240f3c744dd6b6ec2920b3cd08dcc295161ae)
Maven home: D:\apache-maven-3.9.6
Java version: 17.0.8, vendor: Oracle Corporation, runtime: D:\jdk17
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

若提示「‘mvn’ 不是内部或外部命令」：检查 MAVEN_HOME 路径是否正确，Path 中是否添加 %MAVEN_HOME%\bin。

四、优化 Maven 配置（核心：镜像 + 本地仓库）

默认 Maven 从中央仓库下载依赖，速度慢，需修改 settings.xml 配置阿里云镜像，并指定本地仓库路径。

步骤 1：找到 settings.xml 文件

Maven 有两个 settings.xml 位置，优先修改用户级配置：

全局配置（不推荐）：Maven解压目录/conf/settings.xml（修改后对所有用户生效）。
用户级配置（推荐）：在系统盘「用户目录」下新建 .m2 文件夹（如 C:\Users\你的用户名\.m2），将 Maven解压目录/conf/settings.xml 复制到该文件夹，后续修改这个复制后的文件（仅对当前用户生效，不影响全局）。

步骤 2：修改 settings.xml 核心配置

打开复制后的 settings.xml，替换为以下内容（关键部分已标注）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55


<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          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">

  <!-- 1. 指定本地仓库路径（建议非系统盘，避免C盘满） -->
  <localRepository>D:\maven-repository</localRepository>

  <!-- 2. 配置阿里云镜像（解决依赖下载慢） -->
  <mirrors>
    <mirror>
      <id>aliyunmaven</id>
      <!-- 匹配所有中央仓库请求 -->
      <mirrorOf>central</mirrorOf>
      <!-- 阿里云镜像地址 -->
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
    <!-- 可选：Spring 官方仓库镜像（若需下载 Spring 快照版） -->
    <mirror>
      <id>spring-milestones</id>
      <mirrorOf>spring-milestones</mirrorOf>
      <url>https://maven.aliyun.com/repository/spring-milestones</url>
    </mirror>
  </mirrors>

  <!-- 3. 配置 JDK 版本（强制 Maven 使用指定 JDK 编译） -->
  <profiles>
    <profile>
      <id>jdk-17</id>
      <activation>
        <activeByDefault>true</activeByDefault>
        <jdk>17</jdk>
      </activation>
      <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
      </properties>
    </profile>
    <!-- 若用 JDK 8，替换为：
    <profile>
      <id>jdk-8</id>
      <activation>
        <activeByDefault>true</activeByDefault>
        <jdk>8</jdk>
      </activation>
      <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <maven.compiler.compilerVersion>8</maven.compiler.compilerVersion>
      </properties>
    </profile>
    -->
  </profiles>
</settings>

关键配置说明

localRepository：本地仓库路径，所有下载的依赖都会存到这个文件夹，建议设置为非 C 盘（如 D:\maven-repository）。
mirrors：镜像仓库，阿里云镜像比官方中央仓库快 10 倍以上，是必配项。
profiles：强制指定 JDK 编译版本，避免 Maven 用系统默认低版本 JDK 编译报错。

五、IDEA 中集成自定义 Maven（关键）

IDEA 内置了 Maven，但建议使用自己配置的 Maven（避免版本不一致），步骤如下：

步骤 1：打开 IDEA Maven 配置

打开 IDEA →「File」→「Settings」（Windows）/「IntelliJ IDEA」→「Settings」（Mac）。
搜索「Maven」，进入「Build, Execution, Deployment」→「Build Tools」→「Maven」。

步骤 2：配置核心参数

配置项	配置值
Maven home directory	选择自己解压的 Maven 路径（如 `D:\apache-maven-3.9.6`），不要选 IDEA 内置的
User settings file	勾选「Override」，选择自己修改后的 `settings.xml`（如 `C:\Users\用户名\.m2\settings.xml`）
Local repository	自动识别 `settings.xml` 中的 `localRepository`，无需手动修改

步骤 3：应用并验证

点击「Apply」→「OK」，新建 / 打开 Spring Boot 项目时，IDEA 会自动使用你配置的 Maven 下载依赖，速度会明显提升。

六、常见问题及解决方案

问题 1：mvn -v 提示找不到 JDK

原因：JAVA_HOME 配置错误，或 Maven 没识别到 JDK。
解决方案：
1. 确认 JAVA_HOME 指向 JDK 根目录（如 D:\jdk17，不是 jdk17\bin）。
2. 重启 cmd 窗口，重新执行 mvn -v。

问题 2：IDEA 下载依赖仍慢

原因：IDEA 没生效自定义的 settings.xml。
解决方案：
1. 确认「User settings file」已勾选「Override」并指向正确路径。
2. 点击 IDEA 右侧「Maven」→「刷新按钮」（Reimport All Maven Projects），强制重新加载配置。
3. 清空本地仓库（删除 D:\maven-repository），重新下载依赖。

问题 3：本地仓库路径含中文导致依赖下载失败

解决方案：
1. 修改 settings.xml 中的 localRepository 为纯英文路径（如 D:\maven-repo）。
2. 重启 IDEA 和 cmd，重新执行 mvn clean install。

总结

核心步骤：下载解压 Maven → 配置 MAVEN_HOME 和 Path → 修改 settings.xml（镜像 + 本地仓库 + JDK）→ IDEA 集成自定义 Maven。
关键优化：阿里云镜像必须配，解决依赖下载慢；本地仓库指定非 C 盘，避免系统盘占用过大；JDK 编译版本要与本地 JDK 一致。
验证方式：mvn -v 验证环境变量，IDEA 下载依赖速度验证镜像配置，两者都正常则配置完成。