1、概述

• 基本设置

• 依赖设置

• 构建设置

• 项目信息设置

• 环境设置

2、基本配置

2.1 modelVersion

2.2 groupId、artifactId、version

• groupId - 团体、组织的标识符。团体标识的约定是，它以创建这个项目的组织名称的逆向域名(reverse domain name)开头。一般对应着 java 的包结构。

• artifactId - 单独项目的唯一标识符。比如我们的 tomcat、commons 等。不要在 artifactId 中包含点号 .。

• version - 项目的版本号。版本号命名是有规定的，例如 Spring Boot 采用的版本号命名风格。



• Major 主版本号，当有非兼容性的变更时，递增主版本号。
• Minor 次版本号，当以可向后兼容的方式增加了功能时，递增次的版本号。
• Patch 补丁版本号，当有向后兼容的 bug 修复时，递增补丁版本号。
• Label 标记，用来区分开发版、快照版、里程碑版、正式发行版。各个版本说明如下：
• SNAPSHOT - 这个版本一般用于开发过程中，表示不稳定的版本。每次刷新项目依赖时都会去远程库中查看是否有最新版本。
• LATEST - 指某个特定构件的最新发布，这个发布可能是一个发布版，也可能是一个 snapshot 版，具体看哪个时间最后。
• RELEASE ：指最后一个发布版。只要版本号不变，就算远程库中该版本号的项目进行了更新，也不会去远程库中拉取最新版本的项目

2.3 packaging

• pom：在父级项目中的 pom.xml 文件使用的 packaging 配置一定为 pom。父级的 pom 文件只作项目的子模块的整合，在 maven install 时不会生成 jar/war 压缩包。

父级 pom 文件的作用：

• 可以通过 <modules> 标签来整合子模块的编译顺序（Maven引入依赖使用最短路径原则，例如 a<–b<–c1.0 ，d<–e<–f<–c1.1，由于路径最短，最终引入的为 c1.0；但路径长度相同时，则会引入先申明的依赖）。因此尽量将更加底层的 service 放在更先的位置优先加载依赖较为合适。

• 可以将一些子项目中共用的依赖或将其版本统一写到父级配置中，以便统一管理。

• groupId、artifactId、version能直接从父级继承，减少子项目的 pom 配置。

• jar：默认打包方式，这种打包方式意味着在 maven build 时会将这个项目中的所有 java 文件都进行编译形成 .class 文件，且按照原来的 java 文件层级结构放置，最终压缩为一个 jar 文件。

• war：war 包与 jar 包非常相似，同样是编译后的 .class 文件按层级结构形成文件树后打包形成的压缩包。不同的是，它会将项目中依赖的所有jar包都放在 WEB-INF/lib 这个文件夹下。 WEB-INF/classes 文件夹仍然放置我们自己代码的编译后形成的内容。war 包非常适合部署时使用，不再需要下载其他的依赖包，能够使用户拿到 war 包直接使用，因此它经常使用于微服务项目群中的入口项目的 pom 配置中。

3、依赖配置

3.1 parent

• relativePath - 注意 relativePath 元素。在搜索本地和远程存储库之前，它不是必需的，但可以用作 maven 的指示符，以首先搜索给定该项目父级的路径。

3.2 properties

• 内置属性：主要用两个常用内置属性
• ${basedir} 表示项目根目录，即包含 pom.xml 文件的目录。
• ${version} 表示项目版本。

• POM 属性：引用本 POM 文件中对应元素的值。如 ${project.artifactId} 就对应了 <project><artifactId>xxx</artifactId></project> 元素的值，常用的 POM 属性包括：
• ${project.build.sourceDirectory} ：项目的主源码目录，默认为 src/main/java/
• ${project.build.testSourceDirectory} ：项目的测试源码目录，默认为 src/test/java/
• ${project.build.directory} ：项目构建输出目录，默认为 target/
• ${project.outputDirectory} ：项目主代码编译输出目录，默认为 target/classes/
• ${project.testOutputDirectory} ：项目测试主代码输出目录，默认为 target/testclasses/
• ${project.groupId}：项目的 groupId
• ${project.artifactId}：项目的 artifactId
• ${project.version}：项目的 version，与 ${version} 等价
• ${project.build.finalName}：项目打包输出文件的名称，默认为 {project.artifactId}-${project.version}

• Settings 属性：同理 POM 属性，引用 settings.xml 文件中的 XML 元素的值，以 settings. 开头。如 ${settings.localRepository} 指向用户本地仓库的地址。

• Java 属性：引用 java 系统属性，以 java. 开头，如 ${java.home} 指向了 java 根目录。

• ENV 属性：引用所有环境变量属性，以 env. 开头，如 ${env.JAVA_HOME} 指代了 JAVA_HOME 环境变量的的值。

• 自定义属性。可在其他地方通过 ${} 来引用该属性。例如下面就定义了 java 属性的版本号，并自定义了一个 file.encoding 属性。

3.3 dependencies

• groupId, artifactId, version - 和基本配置中的 groupId、artifactId、version 意义相同。

• type - 对应 packaging 的类型，如果不使用 type 标签，maven 默认为 jar。

• scope - 此元素指的是任务的类路径（编译和运行时，测试等）以及如何限制依赖关系的传递性。有 5 种可用的限定范围：
• compile - 默认的 scope ，参与当前项目的编译、运行、测试、打包等全过程参与（程序员写的业务代码）。此外，这些依赖关系被传播到依赖项目。
• provided - 编译、运行、测试阶段参与，打包阶段不参与，不可传递。（例如servlet-api.jar、JDK）。
• runtime - 编译不参与，在运行、测试、打包阶段参与。（例如mysql.jar 驱动）
• test - 只在测试阶段参与，编译、运行和打包阶段不参与，不可传递。（例如junit.jar）
• system - 不是从本地 maven 仓库引入，而是在本地目录的下的 jar，与 provided 相似 。一般不使用。 （oracle 驱动 ojdbc14.jar）

• systemPath - 仅当依赖范围是系统时才使用。否则，如果设置此元素，构建将失败。该路径必须是绝对路径，因此建议使用 propertie 来指定特定的路径，如$ {java.home} / lib。由于假定先前安装了系统范围依赖关系，maven 将不会检查项目的仓库，而是检查库文件是否存在。如果没有，maven 将会失败，并建议您手动下载安装。

• optional - optional 用来控制当前依赖是否向下传递成为间接依赖；optional 默认值为 false，表示可以向下传递称为间接依赖；为 true 则表示当前依赖不能向下传递成为间接依赖。仅适用于项目的单纯依赖关系，不适合父子工程。假设 A 工程是 parent，那么 A 工程即便加上了 optinal，子项目也将继承父工程的所有依赖关系。

3.4 dependencyManagement

3.5 modules

4、构建配置

4.1 bulid

1. 基本构建配置

2. 扩展配置

3. 目录配置

4. 资源配置

5. 插件配置

4.1.1 基本构建配置

4.1.2 扩展配置

4.1.3 目录配置

4.1.4 资源配置

4.1.5 插件配置

4.2 reporting

5、环境信息设置

6、环境设置

6.1 repositories

6.2 distributionManagement

6.3 profiles

• activation 激活。在 activation 中配置了默认的选项 activeByDefault，所以默认激活的是 prod 环境。

• 命令行激活。在命令行使用 -P 参数可以激活 test 环境。

• activeProfiles 激活。下面配置也可以激活 test 环境

profile 配置项在 setting.xml 中也有，是 pom.xml 中 profile 元素的裁剪版本，只包含了 id， activation ，repositories ，pluginRepositories 和 properties 五个元素。如果一个 settings 中的 profile 被激活，它的值会覆盖任何其它定义在 POM 中或者 profile.xml 中的带有相同 id 的 profile。参考Maven系列：Settings配置。

参考