前言
在使用Maven进行Java项目开发时，我们经常在pom.xml中声明各种依赖，比如：
<dependency>
<groupId>org.jamel.dbf</groupId>
<artifactId>jamel</artifactId>
<version>0.06</version>
</dependency>你有没有想过一个问题：Maven到底是怎么通过这短短几行坐标，精确找到本地磁盘上对应的JAR文件的？ 今天我们就来把这个过程彻底讲清楚。
目录
一. 第一步：找到IDEA中配置的本地Maven仓库路径
Maven在本地会维护一个"仓库"，所有下载过的依赖都会缓存在这里。要搞清楚依赖文件存放在哪里，首先要找到这个本地仓库的路径。
在IDEA中查看的方式：
打开 File → Settings → Build, Execution, Deployment → Build Tools → Maven，你会看到以下几个关键配置项：
- Maven home path：Maven的安装目录
- User settings file：
settings.xml的位置 - Local repository：本地仓库的路径
其中 Local repository 就是我们要找的答案。如果你没有手动指定，Maven默认会使用 ~/.m2/repository 作为本地仓库路径。
假设我在IDEA中配置的本地仓库路径为：
/home/jhj/java/apache-maven-3.6.0/repository那么所有通过Maven下载的依赖，都会按照固定规则存放在这个目录下。
二. 第二步：理解Maven依赖坐标（GAV）
Maven用一组坐标来唯一标识一个依赖，这组坐标叫做 GAV，包含三个核心字段：
| 字段 | 含义 | 示例 |
|---|---|---|
groupId | 组织或项目的唯一标识 | org.jamel.dbf |
artifactId | 项目中的某个模块或组件 | jamel |
version | 版本号 | 0.06 |
这三个字段组合在一起，就能唯一确定一个依赖。
三. 第三步：根据坐标算出依赖文件的具体目录
这是本文的核心内容。Maven将GAV坐标映射到本地目录的规则非常清晰，只需要记住一个公式：
依赖文件目录 = 本地仓库根目录 / groupId（
.换成/） / artifactId / version/
具体拆解如下：
| 坐标字段 | 值 | 转换规则 | 对应目录 |
|---|---|---|---|
groupId | org.jamel.dbf | 将 . 替换为 / | org/jamel/dbf/ |
artifactId | jamel | 直接使用 | jamel/ |
version | 0.06 | 直接使用 | 0.06/ |
将以上各部分拼接起来：
本地仓库根目录：/home/jhj/java/apache-maven-3.6.0/repository
groupId路径： org/jamel/dbf
artifactId： jamel
version： 0.06最终得到的完整路径为：
/home/jhj/java/apache-maven-3.6.0/repository/org/jamel/dbf/jamel/0.06/这就是该依赖在本地磁盘上的具体存放目录。
四. 该目录下有哪些文件？
进入 0.06/ 目录后，你通常会看到以下文件：
jamel-0.06.jar ← 实际的依赖包（核心产物）
jamel-0.06.pom ← 该依赖自身的POM文件（包含传递依赖信息）
jamel-0.06.jar.sha1 ← JAR文件的SHA1校验值
jamel-0.06.jar.md5 ← JAR文件的MD5校验值
_remote.repositories ← 记录该文件是从哪个远程仓库下载的其中 jamel-0.06.jar 就是Maven最终加载到项目 classpath 中的文件。
五. 完整工作流程总结
整个依赖查找的过程可以概括为以下几步：
- 读取坐标：Maven读取
pom.xml中的<dependency>声明，获取groupId、artifactId、version。 - 计算路径：按照
本地仓库根目录 / groupId(点号换成斜杠) / artifactId / version/的规则，计算出本地路径。 - 检查本地：查看该目录下是否已经存在对应的JAR文件。
- 命中则直接使用：如果文件存在，直接加入项目 classpath，不再访问远程仓库。
- 未命中则下载：如果本地不存在，Maven会按照
settings.xml中配置的仓库顺序，依次从中央仓库、私服等远程仓库下载，下载完成后按相同规则存入本地仓库。
六. 核心要点回顾
groupId中的.就是目录分隔符/，这是最关键的转换规则。- 文件命名规则固定为：
artifactId-version.后缀（如jamel-0.06.jar）。 - 同一个坐标在本地永远只存一份，所有引用该依赖的项目共享同一份JAR文件，这也是Maven依赖管理的核心设计思想。
理解了这套映射规则，以后遇到依赖找不到的问题，你就可以直接去本地仓库对应目录下检查文件是否存在，快速定位问题所在。
转载自 CSDN-专业IT技术社区
原文链接：https://blog.csdn.net/qq_63981644/article/details/165479194
