Java 项目构建工具 Maven 入门指南：依赖管理与仓库配置

运行结果如下：

打包是将所有 class 文件整合成 jar 包或 war 包。jar 包可引入其他项目直接使用其中的类和属性，也可打成可执行 jar 包通过 java -jar 命令运行。war 包通常用于 Web 项目，包含网站所需的所有资源。

4.2 依赖管理

依赖即第三方 jar 包或框架。使用依赖后，我们无需自己从头创建。比如想吃大米不用自己种，直接买现成的即可。

早期 JDK 中没有 Maven，需手动下载 jar 包并添加到项目结构中。现在，只需在 pom.xml 中引入依赖坐标，Maven 会自动处理。

<dependencies>
    <!-- 里面放置项目的依赖坐标，可为多个 -->
</dependencies>

以 MySQL 驱动为例，在 pom.xml 中添加依赖配置：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.30</version>
</dependency>

点击刷新按钮，IDEA 会自动下载新加入的依赖 jar 包：

后续添加新 jar 包或修改版本，均通过此方式在项目中维护。

刷新后可在项目中看到下载的 jar 包：

4.2.1 依赖传递

早期手动管理依赖时，若 A 依赖 B，B 依赖 C，则 A 项目引入 B 的同时也需引入 C。我们需要知道每个库的依赖关系及版本关联，过程繁琐。

使用 Maven 后，只需在 pom.xml 中定义直接依赖。由于 Maven 的依赖具有传递性，会自动导入所依赖的其他 jar 包。

如上图，项目 A 通过 Maven 引入 Jar A 时，会自动引入 Jar B 和 Jar C。Jar A 和项目 B 是直接依赖，Jar B 和 Jar C 是间接依赖。

我们可以下载 MavenHelper 插件查看依赖关系：

安装成功后按以下步骤操作：

4.2.2 依赖排除

随着项目复杂化，库之间的依赖关系也会变得复杂。如果项目 A 不需要 Jar B，可以通过排除依赖的方式实现。

排除依赖指主动断开对某些资源的引用（被排除的资源无需指定版本）。

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>6.0.6</version>
    <!-- 排除依赖 -->
    <exclusions>
        <exclusion>
            <artifactId>spring-jcl</artifactId>
            <groupId>org.springframework</groupId>
        </exclusion>
    </exclusions>
</dependency>

Maven 还有依赖调解功能。当项目中的依赖存在冲突时（例如 A->B->C->X(1.0)，A->D->X(2.0)），Maven 会采用最短路径优先原则选择依赖（此处选 X(2.0)）。当然，我们也可以强制指定某个依赖的版本。

5. Maven 仓库

5.1 什么是 Maven 仓库

我们通过几行代码就能将依赖 jar 包放入项目，具体原理是什么？

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.30</version>
</dependency>

这段代码称为'坐标'，由 groupId、artifactId、version 唯一标识一个 jar 包。配置完依赖后点击刷新，Maven 会根据坐标去仓库寻找 jar 包并下载。这个存储 jar 包的目录就称为仓库。

Maven 仓库本质是一个目录，用于存储开发中所有依赖（jar 包、插件等）。分为两大类：本地仓库和远程仓库（中央仓库、私服、其他公共库）。

5.2 本地仓库

本地仓库是计算机上的一个目录，用于存储 jar 包。当项目中引入依赖后，Maven 首先查找本地仓库是否有对应 jar 包：

• 如果有，直接引用；
• 如果没有，则去中央仓库下载并缓存到本地仓库。

本地仓库地址可通过 IDEA 配置查看：File -> Settings。

查看该仓库目录，可以看到其中存储了很多 jar 包（初始为空，随使用逐渐增多）。

5.3 中央仓库

中央仓库是 Maven 软件内置的远程仓库地址，服务于整个互联网，由 Maven 团队维护，全球唯一。

仓库地址：https://repo1.maven.org/maven2/

可通过 https://mvnrepository.com 查询并下载 jar 包坐标：

1. 访问 mvnrepository.com 查看坐标。

2. 选择要添加的版本。

3. 查找特定 jar 包，如 mysql。

5.4 私有服务器（私服）

私服一般由公司团队搭建的私有仓库，属于特定公司或部门，往往需要权限。有了私服后，Maven 依赖下载顺序发生变化：

当 Maven 需要下载资源时：

1. 先从本地仓库获取，存在则直接返回；
2. 本地没有，从私服请求，存在则返回；
3. 私服不存在，从中央仓库下载；
4. 中央仓库存在，先缓存在私服，再缓存到本地仓库，最后提供服务。

私服的优势在于多人共享，第一个使用者下载一次后，其他人可直接从私服获取。

5.5 设置国内 Maven 源

首次创建 Maven 项目耗时较长，通常是因为使用了位于国外的中央仓库，下载速度较慢。我们可以配置国内镜像源（如阿里云）加速。

默认情况下，本地仓库和本地仓库在 C 盘。若希望将文件改到 F 盘（例如 IDEA 安装在 F 盘），可按以下步骤操作。

进入 settings.xml 配置文件目录：

粘贴修改后的配置：

将中央仓库替换为阿里云仓库：

用 IDEA 打开 settings.xml 文件，修改如下内容并保存：

<mirror>
    <id>alimaven</id>
    <mirrorOf>central</mirrorOf>
    <name>aliyun maven</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
</mirror>

配置完成后，再次查看 Maven 仓库设置确认生效：

上述国内 Maven 源更改成功后，创建 Maven 项目时也可直接选择国内源。