Maven pom.xml怎么配置 pom.xml文件标签详解

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.slf4jslf4j-log4j12
• 依赖版本尽量由 或父 POM 统一管理，避免子模块各自声明导致不一致

构建配置：build 与 plugins

真正控制“怎么编译、怎么打包、怎么运行”的地方，重点在 。

• maven-compiler-plugin：指定 Java 源码和目标字节码版本，例如 1717
• maven-jar-plugin：控制 JAR 包生成，常用配置 com.example.App 生成可执行 jar
• 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。