【2026实测】Maven下载、安装、配置一篇搞定(附官网安装包)

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

Maven 是 Apache 软件基金会旗下的开源项目构建和依赖管理工具,几乎是 Java 开发者的标配。它主要解决了两件最麻烦的事:
本文系统讲解 Maven 的下载、安装和配置全过程,全程实测,确保大家不会踩坑,文章里提供的 Maven 资源包全部来自官方原版,纯净无捆绑,长期维护更新,可放心下载使用。

Maven 的核心是"约定优于配置":项目目录结构、构建流程都有标准约定,开发者只要遵循规范,几乎不用额外配置就能完成构建。它通过 pom.xml 文件管理项目信息、依赖和插件,本地仓库会缓存所有下载过的依赖,配合中央仓库,全世界的 Java 库都能一键引入。

同领域的 Java 构建工具还有几款,看看它们的区别:

工具名称 是否免费 配置方式 依赖管理 特点
Maven 免费开源 XML(pom.xml) 内置,生态成熟 约定优于配置,使用最广泛
Gradle 免费开源 Groovy/Kotlin DSL 内置 构建速度快,配置灵活
Ant 免费开源 XML(build.xml) 不内置(需Ivy) 老牌工具,已逐渐被取代

Maven 的核心优势在于生态和规范,使用人数最多、插件最丰富、教程资料最全,绝大多数 Java 项目和 IDE 都默认支持 Maven。Gradle 在构建速度上有优势,但 Maven 对新手更友好,上手门槛低。

Maven下载

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

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

Maven 依赖 Java 运行环境,所以先手把手教大学安装 JDK。Maven 3.9.x 要求 Java 8 及以上,这里教大家安装 JDK 21:
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的版本信息,说明安装和配置成功。

安装Maven

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


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


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


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

Maven新手注意事项

1)新手最容易遇到的问题就是 mvn  -version 提示"mvn 不是内部或外部命令"。这是环境变量没配置好造成的:要么 MAVEN_HOME 指向的目录不对(要指向包含 bin 文件夹的那层目录),要么 Path 里没加 %MAVEN_HOME%\bin,要么配置完没有重新打开命令行窗口。按顺序检查这三处,基本都能解决。

2)Maven 必须依赖 JDK,如果输入 mvn -v 报错提示找不到 Java 环境,说明 JDK 没装好或环境变量没配置。

总结

Maven 是 Java 开发绕不开的核心工具,免费开源、约定优于配置、依赖管理强大,一条命令搞定编译、测试、打包全流程。

安装 Maven 本身很简单,解压加配置环境变量几分钟就能完成,新手只要注意先装好 JDK、配好 MAVEN_HOME 和 PATH,再顺手把国内镜像源和本地仓库位置配置好,就能顺畅使用。无论是个人学习还是团队项目,Maven 都能让 Java 构建变得规范又高效。