gav是maven中唯一标识依赖的坐标系统,由groupid(组织域名倒序)、artifactid(模块小写短横线名)和version(语义化版本含-snapshot)三部分组成,共同构成仓库中构件的精确路径定位依据。

Maven 中的 GAV 不是随便起的名字,而是项目或依赖在全世界范围内被精准识别的“唯一身份证”。它不只是一组配置字段,而是整套依赖查找、下载、解析机制的底层依据。
GroupId 是组织归属标识
它代表项目所属的组织或公司,通常采用域名倒序形式(如 com.example.myapp),确保全球唯一性。同一个组织下不同项目可共用相同 groupId,但不能和别人重复——就像“北京市朝阳区”能定位到具体行政区域,避免和其他“朝阳区”混淆。
- 常见写法:com.alibaba、org.springframework、cn.edu.tsinghua
- 不能只写 myproject 这类无组织信息的值,否则无法区分同名项目
- 实际路径映射:groupId 中的点(.)会转为文件系统中的斜杠(/),例如 com.example → com/example/
ArtifactId 是项目模块名称
它是当前 Maven 工程自身的名称,对应生成的 jar 包基础名(不含版本号)。它和 groupId 组合起来,共同构成项目在组织内的唯一模块标识。
- 推荐小写字母+短横线风格,比如 user-service、common-utils
- 不要包含版本信息,像 user-service-1.0 是错误写法
- 最终 jar 文件名由 artifactId-version 拼接而成,如 user-service-2.3.0.jar
Version 是状态与演进标记
它不只是数字编号,还承载着语义化版本含义(如 1.2.0 表示正式发布,1.2.0-SNAPSHOT 表示正在开发中的快照版)。Maven 依靠 version 判断是否需要更新依赖、是否允许覆盖本地缓存。
- -SNAPSHOT 版本每次构建都可能变化,Maven 会检查远程仓库是否有新快照
- 正式版(如 2.1.4)默认不可变,下载后长期缓存在本地仓库
- version 参与路径拼接:com/example/user-service/2.1.4/user-service-2.1.4.jar
GAV 合起来才能定位一个构件
单独看任何一个字段都没法锁定目标。只有三者组合,才能像经纬度加海拔一样,在 Maven 仓库中精确定位一个 jar 文件。Maven 下载依赖时,就是把这三个值拼成目录路径,再到本地或远程仓库里找对应文件。
- 查找逻辑:groupId/artifactId/version/artifactId-version.ext
- 例如:org.junit:junit:4.13.2 → org/junit/junit/4.13.2/junit-4.13.2.jar
- 所有依赖声明、插件引用、模块引用,底层都靠这套坐标系统驱动
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











