Maven 坐标系统说明

Maven 坐标系统说明

Maven 使用坐标系统来唯一标识一个依赖库，由三个核心字段组成。

核心字段

groupId（组ID）

组织或公司的唯一标识符，表示这个库属于哪个组织。通常使用反向域名的方式命名。

示例：com.example.library

artifactId（构件ID）

项目或模块的唯一名称，表示具体是哪个项目或模块。通常使用小写字母和连字符命名。

示例：my-sdk

version（版本号）

库的版本标识。

示例：V001_20260724

---

完整坐标格式

三者组合形成完整的 Maven 坐标，全局唯一标识一个依赖：

{groupId}:{artifactId}:{version}

示例：

com.example.library:my-sdk:V001_20260724

---

仓库存储路径规则

上传到 Maven 仓库后，文件按以下规则存储：

{groupId（.替换为/）}/{artifactId}/{version}/{artifactId}-{version}.{packaging}

示例：

com/example/library/my-sdk/V001_20260724/my-sdk-V001_20260724.zip

注意：artifactId 在路径中出现两次，一次作为目录名，一次作为文件名前缀。

---

路径结构拆解

路径段	对应字段	说明
com/example/library	groupId	点号（.）转换为路径分隔符（/）
my-sdk	artifactId	作为目录名
V001_20260724	version	作为目录名
my-sdk-V001_20260724.zip	文件名	{artifactId}-{version}.{packaging}

---

引用方式

其他项目引用该库时，可使用以下方式：

Gradle：

dependencies {
    implementation 'com.example.library:my-sdk:V001_20260724'
}

Maven：

<dependency>
    <groupId>com.example.library</groupId>
    <artifactId>my-sdk</artifactId>
    <version>V001_20260724</version>
</dependency>