pom.xml 是 Maven 项目的配置核心,需正确配置基础坐标(groupId、artifactId、version)、打包类型(packaging)、依赖(dependencies)及构建插件(build/plugins);标签写错将导致编译失败。

pom.xml 是 Maven 项目的“身份证”和“说明书”,它用 XML 描述项目坐标、依赖、构建行为等关键信息。配置不求全,但核心标签必须写对,否则连编译都通不过。下面按实际开发中最常接触的几类标签来说明。
基础坐标三要素:groupId、artifactId、version
这三个标签合起来构成项目的唯一坐标,Maven 靠它定位、下载、发布构件。
-
groupId:组织或公司标识,通常用反向域名(如 com.example),决定本地仓库路径(
~/.m2/repository/com/example/...) - artifactId:项目模块名,比如 user-service 或 common-utils,不能含大写字母或下划线(推荐小写+短横线)
- version:语义化版本号,常见格式如 1.2.0 或带快照的 1.2.0-SNAPSHOT;SNAPSHOT 表示开发中版本,每次构建会覆盖本地/远程同名快照
打包类型与项目元信息:packaging、name、description
这些虽不参与构建逻辑,但影响产物形态和协作体验。
- packaging:默认是 jar,Web 项目常用 war,父工程用 pom,插件项目用 maven-plugin
- name 和 description:纯描述性字段,用于生成文档、IDE 显示、团队协作理解,不参与构建,但建议填写
- url:可选,指向项目主页或 Wiki,部分插件(如 site 插件)会用到
依赖管理:dependencies 与 dependency
这是日常改动最频繁的部分,每个 至少要包含 groupId、artifactId、version(父 POM 已定义 version 时可省略)。
- scope 控制依赖生效范围:compile(默认,全阶段可用)、test(仅测试编译/运行)、provided(如 servlet-api,由容器提供)、runtime(如 JDBC 驱动)、system(已弃用,不推荐)
-
exclusions 用于排除传递依赖冲突,例如排除某个日志桥接器:
org.slf4j slf4j-log4j12 - 依赖版本尽量由
或父 POM 统一管理,避免子模块各自声明导致不一致
构建配置:build 与 plugins
真正控制“怎么编译、怎么打包、怎么运行”的地方,重点在 。
-
maven-compiler-plugin:指定 Java 源码和目标字节码版本,例如
17 17 -
maven-jar-plugin:控制 JAR 包生成,常用配置
生成可执行 jarcom.example.App -
maven-surefire-plugin:运行单元测试,可配置跳过测试(
-Dmaven.test.skip=true)或指定测试类模式 - 插件建议显式声明
(除 org.apache.maven.plugins 外),并固定,避免因 Maven 版本升级引发行为变化
基本上就这些。不需要一开始就把所有标签填满,从坐标、依赖、编译插件这三块起步,再按需扩展。写错一个斜杠或命名空间,Maven 就会报 schema 错误——所以复制粘贴时务必核对 xmlns 和 xsi:schemaLocation 是否完整匹配 http://maven.apache.org/POM/4.0.0。










