Java 项目构建与管理：Maven 核心实战指南

保存后点击刷新按钮，Maven 会自动下载对应的依赖 jar 包。

4.2.1 依赖传递

早期手动管理依赖时，若 A 依赖 B，B 依赖 C，则需手动处理所有层级关系。Maven 具有依赖传递性，只需定义直接依赖，间接依赖会自动导入。

例如，引入 MySQL 时会自动引入其依赖的 protobuf 库。如需查看依赖树，可借助 IDE 插件辅助分析。

• 直接依赖：当前项目中显式配置的依赖。
• 间接依赖：被依赖资源所引用的其他资源。

4.2.2 依赖排除

随着项目复杂化，某些间接依赖可能不再需要。此时可通过排除依赖的方式主动断开关系。

<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 还支持依赖调解。当存在多个版本冲突时（如路径长度不同），Maven 默认遵循最短路径优先原则，也可手动指定特定版本。

5. Maven 仓库

5.1 什么是 Maven 仓库

Maven 根据 groupId、artifactId、version 的唯一组合识别 jar 包。配置完依赖后，Maven 会根据坐标去仓库查找并下载。这个存储资源的目录即为仓库。

Maven 仓库分为本地仓库和远程仓库。远程仓库又包含中央仓库、私服和其他公共库。

5.2 本地仓库

本地仓库是计算机上的一个目录，用于存储下载的 jar 包。当项目引入依赖时，Maven 首先检查本地仓库是否存在该资源。

• 若存在，直接引用。
• 若不存在，从远程仓库下载至本地。

本地仓库地址可在 IDEA 设置中查看：File -> Settings。

5.3 中央仓库

中央仓库由 Maven 团队维护，是全球唯一的官方远程仓库。地址为 https://repo1.maven.org/maven2/。

查询 Jar 包坐标推荐使用 https://mvnrepository.com/。

5.4 私有服务器（私服）

私服通常由公司搭建，用于内部资源共享。下载顺序变为：本地仓库 -> 私服 -> 中央仓库。

若私服中存在资源则直接返回；若不存在，则从中央仓库下载并缓存到私服，再同步到本地。这能显著减少重复下载，提升团队效率。

5.5 设置国内 Maven 源

由于中央仓库位于海外，首次下载可能较慢。建议配置国内镜像源（如阿里云）以提升速度。

修改 settings.xml 文件中的 <mirror> 配置：

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

保存后，建议在非系统盘（如 F 盘）重新配置本地仓库路径，避免占用 C 盘空间。