Maven-安装与环境配置

最新推荐文章于 2025-10-11 16:08:51 发布

原创最新推荐文章于 2025-10-11 16:08:51 发布 · 1.4k 阅读

29 ·

CC 4.0 BY-SA版权

文章标签：

#maven #java

安装教程专栏收录该内容

24 篇文章

订阅专栏

前言

以下内容是在 Windows 下安装 Maven，如果你想在 Linux 上安装 Maven，可跳转到 Linux - 安装 maven(详细教程)

一、简介

官网：https://maven.apache.org/

在这里插入图片描述

Maven 是一个项目管理和构建自动化工具，主要服务于基于 Java 的项目。它是由 Apache 软件基金会提供的。Maven 遵循一个特定的项目对象模型（Project Object Model，POM），这个模型定义了项目的构建过程、依赖关系和其他配置信息。以下是 Maven 的一些核心特性：

依赖管理：Maven 能够自动处理项目依赖，包括依赖的传递性解析，这意味着如果你的项目依赖了某个库，Maven 会帮你下载这个库以及这个库所依赖的其他库。
项目构建：Maven 提供了一个标准化的项目构建生命周期，包括编译、测试、打包、部署等阶段。
项目信息管理：Maven 可以管理项目的元数据，如项目名称、版本、开发者信息等。
插件和目标：Maven 拥有丰富的插件系统，这些插件可以扩展 Maven 的功能，执行特定的任务，如代码生成、测试覆盖率报告等。每个插件都有一系列的目标（goals），可以被独立调用。
继承和聚合：Maven 支持项目继承，允许子项目继承父项目的配置。同时，它还支持多模块项目（multi-module projects）的聚合构建。
可移植性：Maven 项目是高度可移植的，因为它们包含了构建项目所需的所有信息，包括依赖关系。
中央仓库：Maven 使用一个中央仓库来存储和管理 Java 库，这使得共享和重用代码变得容易。
依赖范围：Maven 允许你指定依赖的范围，比如编译时依赖、测试时依赖、运行时依赖等。
版本管理：Maven 支持对项目版本的管理，可以方便地进行版本升级和依赖的版本控制。
IDE 集成： 大多数集成开发环境（IDE）如 IntelliJ IDEA、Eclipse 等都支持 Maven，使得在 IDE 中管理 Maven 项目变得非常方便。

Maven 的这些特性使得它成为 Java 开发者广泛使用的工具之一，它帮助开发者标准化构建流程，简化项目管理，并提高开发效率。

二、安装前准备

在安装 Maven 之前通常需要先配置 JDK（Java Development Kit），因为 Maven 是用 Java 编写的，并且需要 Java 运行环境来执行。以下是安装 Maven 时配置 JDK 的几个原因：

Java 运行环境：Maven 本身是一个 Java 应用程序，需要 Java 运行时环境（JRE）来运行。
编译 Java 代码：Maven 经常需要编译 Java 代码，这需要 Java 开发工具包（JDK）中的 javac 编译器。
执行 Java 程序：Maven 插件可能会执行一些 Java 程序，这同样需要 JDK。
环境变量配置：在配置 Maven 时，通常需要设置 JAVA_HOME 环境变量指向 JDK 的安装目录，以便 Maven 能够找到 Java 运行时。
版本兼容性：Maven 需要特定版本的 JDK 才能正常工作。例如，较新的 Maven 版本可能需要 JDK 11 或更高版本。

可调出命令窗口（win + R 再输入 cmd），通过 java -version 来检查 JDK 是否已正确安装和配置

在这里插入图片描述

如果没有显示 Java 的版本信息，就需要先配置 Java 环境变量，具体操作可参见：Java-环境配置(详细教程)

三、下载与安装

官网下载地址：https://maven.apache.org/download.cgi

在这里插入图片描述

这里需要注意的是 Binary 是可执行版本，可以直接使用，而 Source 是源代码版本，需要自己编译成可执行软件才能使用。

tar.gz 和 zip 是 maven 两种格式的压缩文件，tar.gz 格式的文件会比 zip 格式的文件小很多，在 Windows 下通常会下载 zip 格式的压缩包，而在 Linux 下则下载 tar.gz 的压缩包。

除了要根据系统来确定下载哪个安装包之外，还需要根据 JDK 的配置来选择所兼容的 Maven 版本，可以在 Release Notes 中查看不同 Maven 所对应的 JDK 版本

在这里插入图片描述

比如说我当前的 JDK 本版是 1.8 的，那么我就应该选择 Required Java Version 为 Java 8 对应的 Maven 版本，可从 Maven 3 archives 进入下载历史版本

在这里插入图片描述

https://archive.apache.org/dist/maven/maven-3/

在这里插入图片描述

以下载 maven-3.9.9 为例，找到对应的目录

在这里插入图片描述

下载完成

在这里插入图片描述

解压安装包

在这里插入图片描述

四、配置环境变量

鼠标右键 我的电脑（此电脑） - 属性 - 高级系统设置 再选择 环境变量

4.1 MAVEN_HOME 配置

点击 环境变量 进来大概是这样子的，点击 新建

在这里插入图片描述

添加配置：

变量名：MAVEN_HOME
变量值：D:\dev\Maven\apache-maven-3.9.9-bin\apache-maven-3.9.9
(maven 的安装目录，可以点击游览目录选择)

在这里插入图片描述

4.2 Path 配置

同时还需要添加 Path 的配置，选择 Path ，点击 编辑

将以下配置复制粘贴放在最前面，再 确定 保存

配置：%MAVEN_HOME%\bin

在这里插入图片描述

环境变量：确定保存

系统属性： 确定 保存

4.3 验证

使用 dos 命名：win + R 再输入 cmd 回车

打开命令窗口输入 mvn -version 回车

在这里插入图片描述

能展示出 maven 的版本信息则说明安装配置完成

五、常用配置

5.1 配置本地仓库

可以在存放 Maven 的目录下创建一个 repository 文件夹，用作 maven 的本地仓库

在这里插入图片描述

找到 maven 的配置文件 setting.xml

在这里插入图片描述

添加以下配置：

<localRepository>D:\dev\Maven\repository</localRepository>

在这里插入图片描述

5.2 配置镜像

在 settings.xml 配置文件中找到 mirrors 节点

添加以下配置：阿里云云效 Maven

<!-- 阿里云仓库 -->
<mirror>
    <id>nexus-aliyun</id>
    <mirrorOf>central</mirrorOf>
    <name>Nexus aliyun</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>

在这里插入图片描述