构建与依赖 / 系统课时
POM 的核心结构
POM 的核心结构
一个能被 Maven 正确识别的项目,首先要有结构合法的 pom.xml。本课直接写出一份可验证的 POM,分清模型版本、项目坐标、打包类型与展示元数据各自负责什么,并用 Maven 命令确认文件能被正常解析。
学习目标
- 写出包含
modelVersion、项目坐标、packaging、name和description的基础 POM。 - 区分会影响依赖坐标与构建产物的字段,避免把展示名称当成项目标识。
- 使用
mvn validate检查 POM 的 XML 结构与 Maven 模型是否有效。
先把最小结构写对
pom.xml 必须以 <project> 为根元素。下面这份示例采用兼容性最广的 POM 模型版本 4.0.0,坐标为 com.example:demo-app:1.0.0-SNAPSHOT,打包类型显式写成 jar。把文件保存到项目根目录即可验证。
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>demo-app</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>jar</packaging>
<name>Demo App</name>
<description>Minimal Maven project used to demonstrate POM metadata.</description>
</project>这里的 modelVersion 描述的是 POM 模型格式,不是应用版本;项目版本由 <version> 决定。groupId、artifactId、version 共同形成 Maven 坐标,其他项目通过这组三元组定位你的构件。
分清坐标、打包类型和展示元数据
最容易混淆的是 artifactId 与 name。前者属于坐标,并参与默认构件文件名;后者只是便于人阅读的显示名称。按上面的示例,默认 JAR 名通常是 demo-app-1.0.0-SNAPSHOT.jar,不会因为 <name> 写成 Demo App 而改变。
| 元素 | 示例值 | 实际作用 |
|---|---|---|
groupId |
com.example |
组织或命名空间,参与依赖坐标 |
artifactId |
demo-app |
当前构件标识,参与依赖坐标和默认文件名 |
version |
1.0.0-SNAPSHOT |
当前构件版本,SNAPSHOT 表示开发快照 |
packaging |
jar |
决定默认生命周期绑定;省略时默认是 jar |
name |
Demo App |
人类可读名称,不改变 Maven 坐标 |
description |
一段项目说明 | 给站点、仓库或工具展示项目用途 |
聚合父工程常用 pom 作为 packaging;Web 项目可能使用 war。不要仅为了“看起来更准确”随意改打包类型,因为不同类型会带来不同的默认构建行为。
常用项目元数据该放哪里
除了 name 和 description,真实项目还常见 <url>、<licenses>、<developers> 与 <scm>。这些字段主要服务发布、制品仓库和项目站点,不参与 groupId:artifactId:version 的依赖解析,因此可以在坐标与构建可用后再补齐。
实务上可以按下面的检查顺序补元数据:先确认坐标唯一,再确认 packaging 与产物一致,随后填写项目主页、许可证与源码仓库。发布到公共仓库前,应保证许可证名称、许可证链接和 SCM 地址都指向真实项目,不要复制模板里的占位信息。
用 validate 验证 POM
在 pom.xml 所在目录运行下面的命令。validate 只执行 Maven 生命周期的验证阶段,适合先检查 POM 能否解析,不要求项目已经写好 Java 源码。
mvn validate预期输出会以成功状态结束,时间与路径等日志会因环境不同而变化,关键结果如下。
[INFO] BUILD SUCCESS如果 XML 标签未闭合,Maven 会在读取项目模型时直接失败;如果把 modelVersion 写成项目版本号,也会因为模型版本不受支持而失败。遇到这类错误时,先修正 POM 结构,再处理依赖或编译问题,定位会更快。