MX
Maven

Maven

Maven 是 Apache 提供的项目管理和构建工具，通过统一的项目结构和依赖管理机制，实现 Java 项目的编译、测试、打包、部署等自动化管理。

开发环境Java开发依赖管理项目构建
638 浏览147 下载

视频教程

1 个
Maven下载安装配置视频讲解B站打开观看

使用文档

1 篇文档 · 27 个章节

Maven下载安装与配置教程

一、什么是 Maven

Maven 是 Apache 开源的项目管理工具，主要用于：

  • 项目依赖管理
  • 项目构建
  • 项目打包
  • 项目测试
  • 多模块项目管理

目前 Java 企业级开发中，Maven 已经成为事实标准。

二、下载 Maven

1、访问官网下载

官网：

https://maven.apache.org/download.cgi

选择最新版 Binary zip archive 下载即可。

历史版本下载：https://archive.apache.org/dist/maven/

2、解压安装

将下载后的压缩包解压到指定目录：

latex
D:\Environment\apache-maven-3.9.11

建议不要放在中文目录中。

三、配置环境变量

1、新建 MAVEN_HOME

变量名：

latex
MAVEN_HOME

变量值：

latex
D:\Environment\apache-maven-3.9.11

2、配置 Path

在 Path 中添加：

latex
%MAVEN_HOME%\bin

3、验证安装

打开 CMD：

bash
mvn -v

输出类似：

latex
Apache Maven 3.9.11
Maven home: D:\Environment\apache-maven-3.9.11
Java version: 21

说明 Maven 安装成功。

Maven 依赖 Java 环境。

首先确保已安装 JDK并且配置了环境变量JAVA_HOME.

四、配置本地仓库

为什么要配置本地仓库

默认情况下 Maven 会将依赖下载到：

latex
C:\Users\用户名\.m2

长期使用会占用大量 C 盘空间。

建议修改到其他磁盘。

例如：

latex
D:\MavenRepository

修改 settings.xml

文件位置：

latex
MAVEN_HOME\conf\settings.xml

找到：

xml
<localRepository>
</localRepository>

修改为：

xml
<localRepository>D:\MavenRepository</localRepository>

五、配置国内镜像

为什么配置镜像

默认从 Maven Central 下载依赖。

国内访问速度较慢。

建议配置阿里云镜像。

修改 settings.xml

找到：

xml
<mirrors>
</mirrors>

添加：

xml

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>*</mirrorOf>
  <name>阿里云公共仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

六、IDEA配置 Maven

1、打开设置

latex
File
 └── Settings
      └── Build, Execution, Deployment
           └── Build Tools
                └── Maven

2、配置 Maven

Maven Home Path

latex
D:\Environment\apache-maven-3.9.11

User settings file

latex
D:\Environment\apache-maven-3.9.11\conf\settings.xml

Local Repository

latex
D:\MavenRepository

3、应用配置

点击：

latex
Apply

然后：

latex
OK

即可生效。

七、常用 Maven 命令

bash
# 清理项目
mvn clean

# 编译项目
mvn compile

# 运行测试
mvn test

# 打包项目
mvn package

# 安装到本地仓库
mvn install

# 下载依赖
mvn dependency:resolve

八、常见问题

1、mvn 命令无法识别

原因：

latex
Path 未配置

检查：

latex
%MAVEN_HOME%\bin

是否加入环境变量。

2、JAVA_HOME 未配置

执行：

bash
mvn -v

提示：

latex
JAVA_HOME is not defined correctly

解决：

配置环境变量：

latex
JAVA_HOME=D:\Environment\jdk-21

并加入：

latex
%JAVA_HOME%\bin

3、依赖下载失败

原因：

  • 网络问题
  • 镜像源失效
  • Maven 仓库损坏

解决：

删除本地仓库中对应依赖重新下载：

latex
D:\MavenRepository

然后执行：

bash
mvn clean install

九、总结

Maven 安装配置主要分为以下步骤：

  1. 下载 Maven
  2. 解压安装
  3. 配置环境变量
  4. 配置本地仓库
  5. 配置阿里云镜像
  6. 配置 IDEA
  7. 验证 Maven 是否安装成功

推荐配置：

latex
JDK：21
Maven：3.9.x
本地仓库：D:\MavenRepository
镜像源：阿里云 Maven
IDE：IntelliJ IDEA

完成以上配置后，即可进行 Spring Boot、Spring Cloud 等 Java 项目的开发。

客服
反馈