首页 2026 Maven 3.9.16 安装与环境变量配置详解(附安装包)

2026 Maven 3.9.16 安装与环境变量配置详解(附安装包)

更新于 2026-09-29

Maven 是做什么的

Maven 是 Apache 基金会旗下的 Java 项目构建工具,核心功能是依赖管理和项目构建流程。在配置文件里声明需要的第三方库后,Maven 会自动从仓库下载并管理,编译、测试、打包、部署这些环节,也都能用 Maven 一条命令完成。IDEA、Eclipse 等主流开发环境都内置了 Maven 集成,是 Java 开发绕不开的基础工具。目前 Apache Maven 的最新稳定版本是 3.9.16,运行需要 JDK 8 及以上版本。

Maven 安装包下载方式

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

Maven 安装步骤

1. 确认 JDK 环境

安装 Maven 前先确认电脑上安装了 JDK 8 及以上版本,命令行执行 java -version 能正常输出版本号,就代表已安装;否则需要先安装 JDK,再装 Maven。

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

Maven 3.9.x 要求 Java 8 及以上,这里演示安装 JDK 21:

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

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

3)等待安装完成,点击“关闭”退出安装程序。JDK 21 现已安装到电脑上。

3. 配置 JDK 环境变量

1)右键点击“此电脑”或“计算机”,选择“属性”。

2)点击“高级系统设置”。

3)在系统属性窗口中,点击“环境变量”按钮。

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

5)点击“新建”,添加 JDK 的 bin 目录路径,例如“D:\JDK21\bin”。

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

7)验证安装:按 Win+R 组合键,输入 cmd 打开命令提示符,执行 java -version 和 javac -version,显示 JDK 21 版本信息即代表配置成功。

4. 安装 Maven

下载 Maven 资源包后得到 zip 压缩包,解压到合适位置即可,例如解压到 D:\apache-maven-3.9.15。

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

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

在命令提示符下执行 mvn -version,输出结果正常即证明 Maven 配置成功。

5. 配置 Maven 国内镜像仓库

Maven 默认从国外中央仓库下载依赖,国内网络下载速度慢甚至经常失败,建议装完 Maven 先做这个配置。打开 Maven 安装目录下的 conf 文件夹,找到 settings.xml 文件,用编辑器打开,在 mirrors 标签里添加以下内容:

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

保存后重新执行 mvn 命令,依赖就会从阿里云镜像下载,速度提升明显。

6. 设置本地仓库位置(可选)

本地仓库是 Maven 存放下载依赖的位置,默认在用户目录下的 .m2/repository 文件夹(如 C:\Users\你的用户名.m2\repository)。依赖会越下越多,占用空间不小,若用户目录在 C 盘,建议将本地仓库改到空间充足的磁盘。

打开 Maven 安装目录下 conf 文件夹里的 settings.xml,找到 localRepository 标签(默认是注释状态),去掉注释并改成你想要的路径,比如:

<localRepository>D:/maven-repo</localRepository>

保存后重新执行 mvn 命令,依赖就会下载到新目录。注意改路径后原来下载过的依赖不会自动迁移,可手动复制旧目录内容过去,或让其重新下载。

Maven 使用注意事项

1)Maven 运行依赖 JDK,电脑上没装 JDK 或版本低于 8,执行 mvn 命令会直接报错,装 Maven 前先把 JDK 环境配好。

2)配置完环境变量后,一定要重新打开一个命令行窗口再执行 mvn -v,在旧窗口里配置不会生效。

3)mvn 命令要在项目根目录(有 pom.xml 文件的那个目录)执行,在别的目录执行会提示找不到 pom.xml 或不是 Maven 项目。

4)依赖下载慢、下载失败是新手最常见的报错,基本都是网络问题,配置好国内镜像基本都能解决。

常见问题

问:Maven 安装包体积有多大? 答:Maven 的安装包只有 9 MB 左右,解压加配置环境变量几分钟就能完成。

问:安装 Maven 前需要准备什么环境? 答:Maven 运行依赖 JDK,电脑上没装 JDK 或版本低于 8,执行 mvn 命令会直接报错,装 Maven 前先把 JDK 环境配好。

问:配置完环境变量后执行 mvn 命令没生效怎么办? 答:配置完环境变量后,一定要重新打开一个命令行窗口再执行 mvn -v,在旧窗口里配置不会生效。