Maven 4.0.0 模式-pom.xml配置详解

Maven 4.0.0 模式-pom.xml配置详解

​ 此 pom.xml 文件涵盖了 Maven 4.0.0 模式支持的所有主要标签，包括项目元数据、依赖管理、构建配置、发布管理等。每个标签都配有详细注释，说明其作用、常见用法和可能的值。

​ 此文件旨在展示标签的完整性，部分配置（如仓库 URL、SCM 地址）是示例值，无法直接运行。实际使用时需根据项目需求调整。

​ 按照 Maven 的逻辑结构组织，从项目坐标到高级配置，层次分明，便于学习。（协同ai生成）

<?xml version="1.0" encoding="UTF-8"?>
<!-- 根元素，定义 Maven POM 文件的命名空间和模式 -->
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd"><!-- POM 文件的模型版本，当前为 4.0.0，固定值 --><modelVersion>4.0.0</modelVersion><!-- 项目坐标：唯一标识项目 --><!-- groupId：组织或项目的标识，通常是反向域名 --><groupId>com.example</groupId><!-- artifactId：项目名称，唯一标识项目 --><artifactId>my-project</artifactId><!-- version：项目版本号，推荐使用语义化版本，SNAPSHOT 表示开发中 --><version>1.0.0-SNAPSHOT</version><!-- packaging：打包类型，常见值包括 jar、war、pom、ear 等 --><packaging>jar</packaging><!-- 项目元数据：提供项目的描述性信息 --><!-- name：项目名称，易于阅读 --><name>My Example Project</name><!-- description：项目描述，通常用于文档生成 --><description>A comprehensive Maven project for learning purposes.</description><!-- url：项目主页或文档地址 --><url>https://www.example.com</url><!-- inceptionYear：项目起始年份 --><inceptionYear>2025</inceptionYear><!-- organization：项目所属组织信息 --><organization><!-- name：组织名称 --><name>Example Inc.</name><!-- url：组织网站 --><url>https://www.example.org</url></organization><!-- licenses：项目许可信息 --><licenses><license><!-- name：许可名称 --><name>Apache License, Version 2.0</name><!-- url：许可详情链接 --><url>https://www.apache.org/licenses/LICENSE-2.0</url><!-- distribution：分发方式，repo 表示可通过仓库分发 --><distribution>repo</distribution><!-- comments：许可备注 --><comments>A business-friendly OSS license</comments></license></licenses><!-- developers：项目开发者信息 --><developers><developer><!-- id：开发者唯一标识 --><id>johndoe</id><!-- name：开发者姓名 --><name>John Doe</name><!-- email：开发者邮箱 --><email>john.doe@example.com</email><!-- url：开发者主页 --><url>https://johndoe.example.com</url><!-- organization：开发者所属组织 --><organization>Example Inc.</organization><!-- organizationUrl：组织链接 --><organizationUrl>https://www.example.org</organizationUrl><!-- roles：开发者角色 --><roles><role>Developer</role><role>Architect</role></roles><!-- timezone：开发者时区 --><timezone>UTC+8</timezone></developer></developers><!-- contributors：项目贡献者信息，类似 developers 但通常是非核心贡献者 --><contributors><contributor><name>Jane Smith</name><email>jane.smith@example.com</email><organization>Community</organization><roles><role>Tester</role></roles></contributor></contributors><!-- mailingLists：项目邮件列表，用于沟通 --><mailingLists><mailingList><!-- name：邮件列表名称 --><name>Dev List</name><!-- subscribe：订阅地址 --><subscribe>dev-subscribe@example.com</subscribe><!-- unsubscribe：取消订阅地址 --><unsubscribe>dev-unsubscribe@example.com</unsubscribe><!-- post：发送邮件地址 --><post>dev@example.com</post><!-- archive：邮件存档地址 --><archive>https://mail.example.com/archive</archive></mailingList></mailingLists><!-- prerequisites：项目构建的前提条件 通常在父 POM 或大型项目中使用 --><prerequisites><!-- 目前 <prerequisites> 仅支持 <maven> 这一子元素 --><!-- maven：最低要求的 Maven 版本 --><maven>3.6.0</maven></prerequisites><!-- modules：多模块项目中列出子模块 --><modules><!-- module：子模块目录名称 --><module>module-a</module><module>module-b</module></modules><!-- properties：定义项目级别的属性，供其他配置引用 --><properties><!-- Java 源码和目标版本 --><maven.compiler.source>11</maven.compiler.source><maven.compiler.target>11</maven.compiler.target><!-- 源文件编码 --><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><!-- 自定义属性 --><spring.version>5.3.20</spring.version></properties><!-- dependencyManagement：统一管理依赖版本，通常在父 POM 中使用 --><dependencyManagement><dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><version>${spring.version}</version></dependency></dependencies></dependencyManagement><!-- dependencies：项目直接依赖的库 --><dependencies><!-- 依赖示例：JUnit 用于测试 --><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.13.2</version><!-- scope：定义依赖的使用范围，控制依赖在项目生命周期中的可用性。可选值及其说明：1. compile（默认）：- 依赖在编译、测试、运行时和打包阶段均可用。- 适用于核心库（如 spring-core、commons-lang）。- 传递性：会传递到依赖该项目的其他项目。2. provided：- 依赖仅在编译和测试阶段可用，运行时由环境提供（如容器）。- 适用于 Servlet API、JSP API 等。- 传递性：不会传递到其他项目。3. runtime：- 依赖在运行时和测试阶段需要，不参与编译。- 适用于数据库驱动（如 MySQL JDBC 驱动）。- 传递性：会传递到其他项目。4. test：- 依赖仅用于测试阶段（编译和运行测试代码）。- 不参与主代码的编译、运行或打包。- 适用于测试框架（如 JUnit、TestNG）或模拟库（如 Mockito）。- 传递性：不会传递到其他项目。5. system：- 依赖从本地文件系统加载，不从 Maven 仓库下载。- 需要配合 <systemPath> 指定本地路径。- 不推荐使用，易导致不可移植。- 传递性：不会传递到其他项目。6. import：- 用于 <dependencyManagement> 中，导入另一个 POM 的依赖管理配置。- 仅在 <dependencyManagement> 有效，通常用于父子 POM 或 BOM（Bill of Materials）。- 不直接影响依赖的生命周期。当前值：test，表示此依赖（JUnit）仅用于测试阶段。--><scope>test</scope><!-- optional：指定依赖是否为可选依赖，控制依赖的传递性。可选值：- true：表示依赖是可选的，不会自动传递到依赖该项目的其他项目。- false（默认）：表示依赖是必需的，会传递到依赖该项目的其他项目。作用：- 当 optional 设置为 true 时，该依赖仅在本项目中使用，其他项目引用本项目时不会继承此依赖。- 适用于以下场景：1. 依赖是项目内部实现细节，不希望暴露给使用方（例如，某些日志实现库）。2. 依赖是可选功能，依赖方可以自行选择是否添加（例如，某些数据库驱动）。3. 避免不必要的传递依赖，减少依赖冲突或臃肿。注意事项：- optional=true 的依赖不会出现在依赖方的类路径中，依赖方需要显式声明该依赖。- 常用于库项目或框架开发（如 Spring 提供的可选依赖）。- 不建议在应用程序项目中滥用 optional=true，因为可能导致依赖方遗漏必要依赖。当前值：true，表示 JUnit 是本项目的可选依赖，仅用于本项目的测试，且不会传递到其他项目。--><optional>true</optional></dependency><!-- 依赖示例：Apache Commons Lang --><dependency><groupId>org.apache.commons</groupId><artifactId>commons-lang3</artifactId><version>3.12.0</version><!-- exclusions：排除传递依赖 --><exclusions><exclusion><groupId>some.unwanted</groupId><artifactId>unwanted-lib</artifactId></exclusion></exclusions></dependency></dependencies><!-- repositories：依赖的远程仓库 --><repositories><repository><!-- id：仓库唯一标识 --><id>aliyun</id><!-- name：仓库名称 --><name>Aliyun Maven Repository</name><!-- url：仓库地址 --><url>https://maven.aliyun.com/repository/public</url><!-- layout：仓库布局，默认值为 default --><layout>default</layout><!-- releases：是否支持发布版本 --><releases><enabled>true</enabled><updatePolicy>daily</updatePolicy><checksumPolicy>warn</checksumPolicy></releases><!-- snapshots：是否支持快照版本 --><snapshots><enabled>false</enabled></snapshots></repository></repositories><!-- pluginRepositories：插件的远程仓库 --><pluginRepositories><pluginRepository><id>aliyun-plugin</id><name>Aliyun Plugin Repository</name><url>https://maven.aliyun.com/repository/public</url><releases><enabled>true</enabled></releases><snapshots><enabled>false</enabled></snapshots></pluginRepository></pluginRepositories><!-- build：构建过程的配置 --><build><!-- defaultGoal：默认构建目标 --><defaultGoal>install</defaultGoal><!-- directory：构建输出目录，默认是 target --><directory>${project.basedir}/target</directory><!-- finalName：最终生成的文件名 --><finalName>${project.artifactId}-${project.version}</finalName><!-- sourceDirectory：源代码目录 --><sourceDirectory>${project.basedir}/src/main/java</sourceDirectory><!-- testSourceDirectory：测试代码目录 --><testSourceDirectory>${project.basedir}/src/test/java</testSourceDirectory><!-- resources：资源文件配置 --><resources><resource><!-- directory：资源文件目录 --><directory>${project.basedir}/src/main/resources</directory><!-- filtering：是否启用变量替换 --><filtering>true</filtering><!-- includes：包含的文件 --><includes><include>**/*.properties</include></includes><!-- excludes：排除的文件 --><excludes><exclude>**/*.bak</exclude></excludes></resource></resources><!-- testResources：测试资源文件 --><testResources><testResource><directory>${project.basedir}/src/test/resources</directory><filtering>false</filtering></testResource></testResources><!-- plugins：构建过程中使用的插件 --><plugins><!-- 插件示例：配置编译插件 --><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.10.1</version><!-- configuration：插件特定配置 --><configuration><source>${maven.compiler.source}</source><target>${maven.compiler.target}</target><encoding>${project.build.sourceEncoding}</encoding></configuration><!-- executions：插件执行的特定阶段 --><executions><execution><id>default-compile</id><phase>compile</phase><goals><goal>compile</goal></goals></execution></executions></plugin></plugins><!-- pluginManagement：统一管理插件版本 --><pluginManagement><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-surefire-plugin</artifactId><version>3.0.0-M7</version><configuration><skipTests>false</skipTests></configuration></plugin></plugins></pluginManagement></build><!-- reporting：生成项目报告的配置 --><reporting><!-- outputDirectory：报告输出目录 --><outputDirectory>${project.basedir}/target/site</outputDirectory><!-- plugins：报告插件 --><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-project-info-reports-plugin</artifactId><version>3.4.1</version><!-- reportSets：报告的子集 --><reportSets><reportSet><id>default</id><reports><report>dependencies</report><report>index</report></reports></reportSet></reportSets></plugin></plugins></reporting><!-- profiles：构建配置文件，用于不同环境 --><profiles><profile><!-- id：配置文件唯一标识 --><id>dev</id><!-- activation：激活条件 --><activation><!-- property：基于属性激活 --><property><name>env</name><value>dev</value></property><!-- jdk：基于 JDK 版本激活 --><jdk>11</jdk><!-- os：基于操作系统激活 --><os><name>Windows 10</name><family>Windows</family></os><!-- file：基于文件存在激活 --><file><exists>${project.basedir}/src/main/resources/dev.properties</exists></file></activation><!-- properties：开发环境的属性 --><properties><env.type>development</env.type></properties><!-- dependencies：开发环境的依赖 --><dependencies><dependency><groupId>org.slf4j</groupId><artifactId>slf4j-api</artifactId><version>1.7.36</version></dependency></dependencies></profile></profiles><!-- distributionManagement：发布配置 --><distributionManagement><!-- repository：发布版本的仓库 --><repository><id>nexus-releases</id><name>Nexus Release Repository</name><url>https://nexus.example.com/repository/releases</url></repository><!-- snapshotRepository：快照版本的仓库 --><snapshotRepository><id>nexus-snapshots</id><name>Nexus Snapshot Repository</name><url>https://nexus.example.com/repository/snapshots</url></snapshotRepository><!-- downloadUrl：项目下载地址 --><downloadUrl>https://nexus.example.com/repository/releases</downloadUrl><!-- site：项目文档站点 --><site><id>project-site</id><name>Project Documentation</name><url>https://www.example.com/docs</url></site></distributionManagement><!-- issueManagement：问题跟踪系统 --><issueManagement><!-- system：问题跟踪系统名称 --><system>JIRA</system><!-- url：问题跟踪系统链接 --><url>https://jira.example.com</url></issueManagement><!-- ciManagement：持续集成系统 --><ciManagement><!-- system：CI 系统名称 --><system>Jenkins</system><!-- url：CI 系统链接 --><url>https://jenkins.example.com</url><!-- notifiers：通知配置 --><notifiers><notifier><type>mail</type><sendOnError>true</sendOnError><configuration><address>ci@example.com</address></configuration></notifier></notifiers></ciManagement><!-- scm：源码管理 --><scm><!-- connection：只读 SCM 连接 --><connection>scm:git:https://github.com/example/my-project.git</connection><!-- developerConnection：开发者读写 SCM 连接 --><developerConnection>scm:git:git@github.com:example/my-project.git</developerConnection><!-- url：SCM 浏览地址 --><url>https://github.com/example/my-project</url><!-- tag：SCM 标签 --><tag>HEAD</tag></scm><!-- parent：父 POM 配置，用于继承 --><parent><groupId>com.example</groupId><artifactId>parent-project</artifactId><version>1.0.0</version><!-- relativePath：父 POM 文件的相对路径 --><relativePath>../parent/pom.xml</relativePath></parent></project>