Maven 核心概念：GAVP 详解
一、什么是 GAVP？
GAVP 是 Maven 项目的四大核心标识属性，相当于项目在 Maven 世界中的"身份证"：
| 属性 | 全称 | 是否必填 | 作用 |
|---|---|---|---|
| G | GroupId | ✅ 必须 | 组织或公司标识（类似"姓"） |
| A | ArtifactId | ✅ 必须 | 项目或模块标识（类似"名"） |
| V | Version | ✅ 必须 | 版本号（类似"出生日期"） |
| P | Packaging | ❌ 可选 | 打包类型（默认 jar） |
二、GAV 命名规范（企业级最佳实践）
1. GroupId：组织标识（最多 4 级）
格式：com.{公司/BU}.业务线[.子业务线]
命名规则：
- 第1级：
com或cn（顶级域名） - 第2级：公司或事业部（如
taobao、alibaba、tmall） - 第3级：业务线（如
tddl、sourcing） - 第4级（可选）：子业务线（如
multilang）
正例：
<groupId>com.taobao.tddl</groupId>
<groupId>com.alibaba.sourcing.multilang</groupId>
❌ 反例 ：
<groupId>myproject</groupId> <!-- 过于简单，无组织信息 -->
2. ArtifactId：项目模块标识
格式：产品线名-模块名
命名规则：
- 使用小写字母和连字符
- - 语义清晰：一看就知道是什么功能
- 必须先去 Maven 仓库查证，确保不重复
正例：
<artifactId>tc-client</artifactId> <!-- 淘宝客户端 -->
<artifactId>uic-api</artifactId> <!-- 用户中心接口 -->
<artifactId>tair-tool</artifactId> <!-- Tair 工具包 -->
<artifactId>bookstore</artifactId> <!-- 书店系统 -->
❌ 反例 ：
<artifactId>api</artifactId> <!-- 太笼统，不知道是哪的 API -->
<artifactId>MyProject</artifactId> <!-- 大写字母不规范 -->
3. Version：版本号管理（重中之重）
推荐格式：主版本号.次版本号.修订号（如 1.2.3）
版本号升级规则
| 版本号 | 升级时机 | 是否兼容 | 示例 |
|---|---|---|---|
| 主版本号 | 不兼容的 API 修改 或产品方向重大变化 |
❌ 不兼容 | 1.0.0 → 2.0.0 |
| 次版本号 | 向下兼容的功能新增（新增类/接口） | ✅ 兼容 | 1.0.0 → 1.1.0 |
| 修订号 | 只修复 bug，不修改方法签名 功能加强但保持 API 兼容 |
✅ 完全兼容 | 1.0.0 → 1.0.1 |
实战示例：
项目初始化：1.0.0
├─ 修复登录bug → 1.0.1（仅修订号+1）
├─ 新增用户注册功能 → 1.1.0（次版本号+1）
└─ 重构核心API，旧接口不兼容 → 2.0.0（主版本号+1）
快照版本：开发中使用 SNAPSHOT 标识，如 1.0.0-SNAPSHOT
三、Packaging：项目类型识别
作用：告诉 Maven"我是什么类型的项目"，IDEA 会根据这个值识别项目结构。
| 取值 | 项目类型 | 打包结果 | 使用场景 |
|---|---|---|---|
| jar | 普通 Java 项目 | .jar 文件 |
默认类型，标准 Java 应用/类库 |
| war | Java Web 项目 | .war 文件 |
需要部署到 Tomcat 的 Web 应用 |
| pom | 父工程/聚合工程 | 不打包 | 用于模块继承和依赖管理 |
配置示例：
<!-- 普通 Java 项目（可省略，默认就是 jar） -->
<packaging>jar</packaging><!-- Web 项目（必须显式声明） -->
<packaging>war</packaging><!-- 父工程（仅用于组织子模块） -->
<packaging>pom</packaging>
四、完整 pom.xml 示例
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"><!-- GAVP 四要素 --><groupId>com.taobao.ecommerce</groupId> <!-- 公司.业务线 --><artifactId>order-service</artifactId> <!-- 订单服务模块 --><version>1.2.5</version> <!-- 当前版本 --><packaging>war</packaging> <!-- Web项目 --><!-- 依赖声明 --><dependencies><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.30</version></dependency></dependencies>
</project>
解读：这是淘宝电商业务线下，订单服务模块的 1.2.5 版本 Web 项目。
五、为什么要有 GAVP？
核心价值：
- 唯一标识：全球 Maven 仓库中，GAV 确保项目唯一性
- 依赖引用：其他项目通过 GAV 坐标引用你的项目
- 版本追溯：清晰的版本号规范，便于升级和维护
- 工具识别：IDEA/Eclipse 根据 GAVP 自动配置项目结构
引用示例：
<!-- 另一个项目要引用上面的 order-service -->
<dependency><groupId>com.taobao.ecommerce</groupId><artifactId>order-service</artifactId><version>1.2.5</version>
</dependency>
六、新手常见误区
❌ 误区 1 ：GroupId 写得太随意
<groupId>mygroup</groupId> <!-- 不规范，看不出组织 -->
❌ 误区 2 ：Version 乱写
<version>1.0</version> <!-- 缺少数位，应为 1.0.0 -->
❌ 误区 3 ：Web 项目忘记写 packaging
<!-- 缺失 <packaging>war</packaging>，会打成 jar 包，无法部署 -->
✅ 正确做法：严格遵守企业级规范，写出清晰、可维护的坐标。
七、总结与记忆口诀
GAVP 记忆法：
- GroupId：公司+业务（公司标识）
- ArtifactId：产品+模块（项目标识）
- Version：三段位版本（版本标识）
- Packaging：jar/war/pom（打包类型）
一句话总结：
GAVP 就是 Maven 项目的"身份证+户口本"，通过规范的命名，让全球数百万 Java 项目有序组织、互相协作。