前言

Maven 是 Java 开发必备的项目管理与构建工具，能自动管理 jar 包、统一项目结构、一键编译打包。很多刚学 JavaWeb 的同学都会卡在 Maven 安装、环境变量、镜像配置、IDEA 集成这几步。这篇文章带你从 0 到 1 完整配置 Maven，一步到位，不踩坑。

一、准备工作

1. 确保已经安装并配置好 JDK（Maven 依赖 JDK）
2. 下载 Maven 安装包：
   • 官网：https://maven.apache.org/
   • 建议下载 3.6.x 或 3.8.x 稳定版
   • 下载后缀为 -bin.zip 的压缩包

二、解压与目录结构

1. 把下载好的 apache-maven-xxx-bin.zip 解压到一个不带中文、不带空格的路径例如：

   plaintext

   D:\develop\apache-maven-3.8.6
   

2. 目录结构说明：
   • bin：包含 mvn 命令
   • conf：配置文件所在目录
   • lib：依赖 jar 包

三、配置环境变量（关键步骤）

1. 新建 MAVEN_HOME

• 此电脑 → 右键属性 → 高级系统设置 → 环境变量
• 系统变量 → 新建
  • 变量名：MAVEN_HOME
  • 变量值：你的 Maven 路径，如 D:\develop\apache-maven-3.8.6

2. 配置 Path

• 找到系统变量里的 Path → 编辑
• 新建：

  plaintext

  %MAVEN_HOME%\bin
  

3. 验证是否安装成功

打开 cmd，输入：

bash

运行

mvn -v

如果出现版本信息，说明安装成功。

四、配置本地仓库（推荐自定义）

Maven 默认会把 jar 包下载到 C 盘，容易占满 C 盘，建议改到其他盘。

1. 在 Maven 目录或其他位置新建一个文件夹作为本地仓库例如：

   plaintext

   D:\develop\maven-repository
   

2. 打开 conf/settings.xml
3. 找到 <localRepository> 注释，在外面添加：

   xml

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

五、配置阿里云镜像（解决下载慢）

Maven 官方仓库在国外，下载极慢，必须换成阿里云镜像。

打开 conf/settings.xml，找到 <mirrors> 标签，添加：

xml

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>central</mirrorOf>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

六、在 IDEA 中配置 Maven

很多同学安装完 Maven，但 IDEA 不生效，就是因为这里没配置。

1. 打开 IDEA
2. File → Settings → Build, Execution, Deployment → Build Tools → Maven
3. 修改三项：
   • Maven home path：选择你的 Maven 目录
   • User settings file：选择 conf/settings.xml
   • Local repository：自动识别你配置的本地仓库
4. 勾选 Override
5. 点击 Apply → OK

七、测试 Maven 是否正常

打开 cmd，执行：

bash

运行

mvn help:system

如果能正常下载依赖，不报错，说明：

• 环境变量 ✅
• 本地仓库 ✅
• 阿里云镜像 ✅
• IDEA 配置 ✅

八、常见问题总结

1. mvn -v 不是内部命令→ 环境变量配置错误，检查 MAVEN_HOME 和 Path
2. 下载 jar 包极慢→ 没配置阿里云镜像
3. IDEA 依然使用默认 Maven→ 必须在 Settings 里手动指定自己的 Maven
4. 仓库目录有中文或空格→ Maven 不识别，必须全英文路径

总结

Maven 安装其实就四步：

1. 解压
2. 配环境变量
3. 改本地仓库
4. 加阿里云镜像

再配合 IDEA 配置，就能愉快地创建 Maven 项目了。