【2026最新】Maven下载安装配置保姆级图文教程(附安装包+图文步骤)

Maven下载地址:Maven安装包(源自官网,长期更新,放心使用)

Maven(全称Apache Maven)是一款基于项目对象模型(POM)的项目管理和构建工具,核心功能是管理Java项目的依赖、编译、测试、打包和部署等全流程。

Maven完全免费开源,跨平台支持Windows、macOS和Linux。最新版本是Maven 3.9.15。

简单了解一下Maven在项目管理工具领域的地位:

构建工具 价格 依赖管理 构建自动化 多模块支持 插件生态
Maven 免费开源 ✓(POM声明式) 丰富
Gradle 免费开源 ✓(DSL编程式) 丰富
Ant + Ivy 免费开源 ✓(配置繁琐) 一般
手动管理 免费

Maven和Gradle是目前Java项目最主流的两个构建工具。Maven胜在规范统一,所有项目都遵循标准的项目结构和生命周期,新手上手容易,老项目中也用得最广。Gradle胜在灵活和构建速度快(增量编译、缓存机制),Android开发已经全面转向Gradle,传统Java企业项目仍大量使用Maven。

Maven下载

Maven下载地址:Maven安装包(含 JDK21,源自官网,长期更新,放心使用)

Maven安装

Maven没有安装程序,下载的是压缩包,解压后配置环境变量就能用。注意,必须确认系统已安装 JDK(Maven 3.9需要JDK 8及以上版本)。

1、JDK安装(已安装的可跳过)

1)下载JDK 21安装包后,双击运行安装程序:


2)点击"下一步"开始安装。默认安装到 C 盘,这里我将其安装到了非系统盘(比如 D:\JDK21\),注意,安装路径要记住,后面配置需要用到。


3)等待安装完成。安装完成后,点击"关闭"退出安装程序。JDK 21现在已经安装到你的电脑上了。

JDK21配置环境变量(重要步骤)

1)右键点击"此电脑"或"计算机",选择"属性":


2)然后点击"高级系统设置":


3)在系统属性窗口中,点击"环境变量"按钮:


4)在系统变量部分,找到并选中"Path"变量,点击"编辑":


5)点击"新建",添加 JDK 的 bin 目录路径,我的是"D:\JDK21\bin":


6)点击"确定"保存所有更改。

7)验证安装是否成功。按组合键 Win+R,输入cmd打开命令提示符(cmd),输入"java -version"和"javac -version",如果显示JDK 21的版本信息,说明安装和配置成功。

2、安装Maven

下载 Maven 资源包后,得到的是一个 zip 压缩包,解压到合适的位置即可,这里我解压到了 D:\apache-maven-3.9.15。


新建系统变量 MAVEN_HOME,变量值为 Maven 的安装目录:


编辑系统变量 Path,添加变量值:;%MAVEN_HOME%\bin:


在命令提示符下执行 mvn -version  ,输出结果如下图所示,证明 Maven 配置成功:

Maven常见使用问题

1)mvn命令找不到或"不是内部或外部命令"

说明环境变量没配置成功。检查MAVEN_HOME变量是否指向了Maven的解压目录,以及Path变量中是否包含了%MAVEN_HOME%\bin。配置完后需要重新打开命令行窗口才能生效。

2)Maven下载依赖非常慢或者卡住不动

默认Maven使用中央仓库(repo.maven.apache.org),国内访问速度慢。按照安装部分的步骤配置阿里云镜像源即可,配置后所有依赖都会从阿里云仓库下载,速度快很多。

总结

Maven是Java开发中离不开的项目管理工具,核心解决两个问题:依赖管理和构建自动化。

下载完 Maven,解压后配好MAVEN_HOME环境变量就能用。如果你是Java开发者,Maven是必学的基础工具,理解了pom.xml的声明式配置后,整个项目依赖的添加和管理会变得非常轻松。