构建与依赖 / 系统课时

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。把文件保存到项目根目录即可验证。

xml
<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 源码。

bash
mvn validate

预期输出会以成功状态结束,时间与路径等日志会因环境不同而变化,关键结果如下。

text
[INFO] BUILD SUCCESS

如果 XML 标签未闭合,Maven 会在读取项目模型时直接失败;如果把 modelVersion 写成项目版本号,也会因为模型版本不受支持而失败。遇到这类错误时,先修正 POM 结构,再处理依赖或编译问题,定位会更快。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

POM 的核心结构

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通