maven配置详解
下载地址：http://maven.apache.org/download.cgi，
添加环境变量：MAVEN_HOME
一、配置文件
maven的配置文件主要有 settings.xml 和pom.xml 两个文件。
1.其中在maven安装目录，例如apache-maven-3.8.1\conf目录下的settings.xml 文件是全局配置文件
2.用户目录的.m2子目录下面的settings.xml的配置只是针对当前用户的配置
3.项目根路径下的pom.xml主要是对当前项目的配置。
局部配置优先于全局配置。 配置优先级从高到低：pom.xml> user settings > global settings
二、settings.xml 配置详解
1.LocalRepository 本地仓库配置：
<localRepository>D:\repository</localRepository>
2.InteractiveMode 用户输入配置：
<interactiveMode>true</interactiveMode>
3.离线模式
<offline>false</offline>
3.插件组，当我们使用某个插件，并且没有在命令行为其提供组织Id（groupId）的时候，Maven就会使用该列表。默认情况下该列表包含了org.apache.maven.plugins和org.codehaus.mojo
<pluginGroups> <pluginGroup>org.sonarsource.scanner.maven</pluginGroup> </pluginGroups>
4.servers 私服服务器配置，配置私服的用户名和密码。配置的私服服务器可以用来发布jar包，与项目的pom.xml文件中发布标签 distributionManagement 中配置的仓库ID相互对应。
<servers> <server> <id>maven-releases</id> <username>developer</username> <password>123456</password> <!--文件被创建时的权限。 --> <filePermissions>664</filePermissions> <!--目录被创建时的权限。 --> <directoryPermissions>775</directoryPermissions> </server> <server> <id>maven-snapshots</id> <username>test</username> <password>test</password> </server> </servers>
5.镜像配置
<mirror> <id>alimaven</id> <name>aliyun maven</name> <url>https://maven.aliyun.com/repository/central</url> <!-- 被镜像的服务器的id --> <mirrorOf>*</mirrorOf> </mirror>
6.Profiles配置。
settings.xml中的profile元素是pom.xml中profile元素的子集。只包含了id、activation、repositories、pluginRepositories和 properties元素。
如果一个settings.xml中的profile被激活，它的值会覆盖任何其它定义在pom.xml中带有相同id的profile。
<profiles> <profile> <id>nexus</id> <!-- 设置默认激活 --> <activation> <activeByDefault>true</activeByDefault> </activation> <repositories> <!-- 配置依赖仓库，可以配置多个仓库，maven会按照顺序进行依赖的加载 --> <repository> <id>nexus</id> <name>nexus</name> <url>http://nexus.maven.cn/repository/maven-public/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> <repository> <id>alimaven</id> <name>aliyun maven</name> <!-- <url>https://maven.aliyun.com/repository/public</url> --> <url>https://maven.aliyun.com/repository/central</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> <!-- 设置插件仓库 --> <pluginRepositories> <pluginRepository> <id>nexus</id> <name>gwm nexus</name> <url>http://nexus.maven.cn/repository/maven-public/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> <profile> <id>sonar</id> <activation> <activeByDefault>true</activeByDefault> </activation> <!-- 配置Sonarquebe 代码扫描插件的全局属性--> <properties> <sonar.host.url> http://localhost:9000 </sonar.host.url> <sonar.login>admin</sonar.login> <sonar.password>admin</sonar.password> </properties> </profile> </profiles>
7. Activation配置，用来设置profile配置激活的条件逻辑。
<activation> <!--profile默认是否激活的标识 --> <activeByDefault>false</activeByDefault> <!--当匹配的jdk被检测到，profile被激活。例如，1.4激活JDK1.4，1.4.0_2，而!1.4激活所有版本不是以1.4开头的JDK。 --> <jdk>1.8</jdk> <!--如果Maven检测到某一个属性（其值可以在POM中通过${name}引用），其拥有对应的name = 值，Profile就会被激活。如果值字段是空的，那么存在属性名称字段就会激活profile，否则按区分大小写方式匹配属性值字段 --> <property> <!--激活profile的属性的名称 --> <name>mavenVersion</name> <!--激活profile的属性的值 --> <value>2.0.3</value> </property> <!--提供一个文件名，通过检测该文件的存在或不存在来激活profile。missing检查文件是否存在，如果不存在则激活profile。另一方面，exists则会检查文件是否存在，如果存在则激活profile。 --> <file> <!--如果指定的文件存在，则激活profile。 --> <exists>${basedir}/file2.properties</exists> <!--如果指定的文件不存在，则激活profile。 --> <missing>${basedir}/file1.properties</missing> </file> </activation>
8.properties 配置，对应profile的扩展属性和pom中properties的属性列表，这些值可以在pom.xml，setting.xml中使用标记${X}来使用，这里X是指属性的名称。
<!-- 1. env.X: 在一个变量前加上"env."的前缀，会返回一个shell环境变量。例如,"env.PATH"指代了$path环境变量（在Windows上是%PATH%）。 2. project.x：指代了POM中对应的元素值。例如: <project><version>1.0</version></project>通过${project.version}获得version的值。 3. settings.x: 指代了settings.xml中对应元素的值。例如：<settings><offline>false</offline></settings>通过 ${settings.offline}获得offline的值。 4. Java System Properties: 所有可通过java.lang.System.getProperties()访问的属性都能在POM中使用该形式访问，例如 ${java.home}。 5. x: 在<properties/>元素中，或者外部文件中设置，以${someVar}的形式使用。 --> <properties>
<project.version>1.0</project.version>
</properties>
9. Repositories 远程仓库配置，可以配置多个。可以配置在<settings>标签中，也可以配置在<profile>标签中（比较常见，配置在<profile>标签中可以根据profile的激活情况动态选择仓库）。配置形式参见《6.Profiles配置》。
10.插件仓库pluginRepositories 配置和repositories相同。
11. 激活profile配置 activeProfiles，用来激活配置的profile。和 activation 配置相比 activeProfiles 配置比较简单，也比较常用。
<activeProfiles> <activeProfile>nexus</activeProfile> </activeProfiles>
三、POM.xml配置文件：
<parent> <!--父项目的构件标识符 --> <artifactId /> <!--父项目的唯一标识符 --> <groupId /> <!--父项目的版本 --> <version /> <!-- 父项目的pom.xml文件的相对路径。 默认值是../pom.xml。 Maven首先在构建当前项目的地方寻找父项目的pom，其次在文件系统的这个位置（relativePath位置），然后在本地仓库，最后在远程仓库寻找父项目的pom。 注意：如果在父项目中通过<modules>指定了子模块，且子模块在父项目目录下，则不需要指定此配置。如果子项目不在父项目的目录下，应该指定此配置。 --> <relativePath>../pom.xml</relativePath> </parent> <!-- 模型版本 --> <modelVersion>4.0.0</modelVersion> <!-- 公司或者组织的唯一标志--> <groupId>com.companyname.project-group</groupId> <!-- 项目的唯一ID-> <artifactId>project</artifactId> <!-- 版本号 --> <version>1.0</version> <!--项目产生的构件类型，例如jar、war、ear、pom --> <packaging>jar</packaging> <!-- 属性配置 --> <properties> <!-- 编译时的编码 --> <maven.compiler.encoding>UTF-8</maven.compiler.encoding> <spring-boot.version>2.3.7.RELEASE</spring-boot.version> </properties> <!-- 依赖配置 --> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> <version>${spring-boot.version}</version>
<!-- Scope的作用域范围包括compile、test、provided、runtime、system、import；有效期间分别为：编译测试运行期间、测试期间、编译测试期间、测试运行期间、
编译测试期间（jar在本地系统文件中）、引入pom依赖。-->
<scope>compile</scope>
<!-- true表示该依赖是可选的，不会被依赖传递 -->
<optional>true</optional>
</dependency> </dependencies> <!-- 依赖声明，不会真正引入包。一般在父pom中进行声明，在子pom中真正引入 --> <dependencyManagement> <dependencies> <dependency> <groupId>cn.hutool</groupId> <artifactId>hutool-core</artifactId> <version>${hutool.version}</version> </dependency> </dependencies> </dependencyManagement> <!-- 编译构建相关配置 --> <build> <!-- 插件申明，一般在父pom中声明，在子pom中真正引入 --> <pluginManagement> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <version>${spring-boot.version}</version> </plugin> </plugins> </pluginManagement> <!-- 插件引入，在父pom中引入以后，所有子pom中都会引入 --> <plugins> <plugin> <groupId>org.sonarsource.scanner.maven</groupId> <artifactId>sonar-maven-plugin</artifactId> <version>3.6.0.1398</version> </plugin> </plugins> </build> <!-- 针对当前项目的远程仓库配置 --> <repositories> <repository> <id>aliyun-public</id> <url>https://maven.aliyun.com/repository/public</url> <snapshots> <enabled>false</enabled> </snapshots> <releases> <enabled>true</enabled> </releases> </repository> </repositories> <!-- 针对当前项目的远程插件仓库配置 --> <pluginRepositories> <pluginRepository> <id>aliyun-public</id> <url>https://maven.aliyun.com/repository/public</url> <snapshots> <enabled>false</enabled> </snapshots> <releases> <enabled>true</enabled> </releases> </pluginRepository> </pluginRepositories> <!--发布本地maven的jar包至远程私服配置，如果mavenjar包版本后缀为‘snapshot‘则匹配至快照snapshotRepository，否则匹配至release仓库中。--> <distributionManagement> <repository> <!-- 此ID和setting.xml 中server中配置的服务器进行对应 --> <id>maven-releases</id> <name>releases</name> <url>http://nexus.maven.cn/repository/maven-releases/</url> <uniqueVersion>true</uniqueVersion> </repository> <snapshotRepository> <id>maven-snapshots</id> <name>snapshots</name> <url>http://nexus.maven.cn/repository/maven-snapshots/</url> </snapshotRepository> </distributionManagement> <!--动态构建配置，通过设置活动的profile，profile中的配置会作用于当前的项目编译构建。
这中配置，需要在pom文件中依赖spring-boot-maven-plugin插件，同时在spring项目的配置文件中指定 spring.profiles.active=@activename@ ,@activename@
就是在下面配置的变量名，例如：@spring.profiles.active@,这样我们在通过maven编译时选择profile为dev的话，编译使用的spring的配置文件就是application-dev
--> <profiles> <profile> <id>dev</id> <properties> <spring.profiles.active>dev</spring.profiles.active> </properties> <activation> <activeByDefault>true</activeByDefault> </activation> </profile> <profile> <id>prod</id> <properties> <spring.profiles.active>prod</spring.profiles.active> </properties> </profile> </profiles>
四、远程仓库的加载
maven仓库依赖下载顺序：
1，在settings.xml文件中配置的本地仓库中寻找依赖，没找到则进入第2步。
2，在settings.xml文件中配置的全局远程仓库中寻找，没找到则进入第3步。
3，在当前项目的pom.xml中配置的远程仓库中寻找，如果没找到则进入第4步。
4，在中央仓库 https://repo.maven.apache.org/maven2 中寻找，如果没找到则抛出依赖无法加载异常。
镜像替换：
1，如果在找寻的过程中，如果发现该仓库有镜像匹配，则直接从镜像仓库中加载。
2，如果仓库的 id 设置成 <mirrorOf>central</mirrorOf>，则会覆盖 maven 的中央仓库配置。
3，如果镜像 ID 设置为 <mirrorOf>*</mirrorOf> 表示匹配所有的仓库，则所有依赖只从此镜像仓库中下载。
4，如果镜像ID 设置为 <mirrorOf>repo1,repo2</mirrorOf>，则匹配仓库repo1和repo2，使用逗号分隔多个远程仓库
5，如果镜像ID设置为 <mirrorOf>*,!repo1</miiroOf>匹配所有远程仓库，repo1除外，使用感叹号将仓库从匹配中排除
建议将镜像地址作为一个 普通仓库repository 进行配置，这样可以在其他 仓库下载不了的情况下查找到此仓库。如果配置了镜像仓库代替其他仓库容易出现在镜像中找不到依赖，导致项目无法编译的问题。
附录：
scope作用域：引用自 https://blog.csdn.net/qq_37269626/article/details/125647272
原文链接：https://www.cnblogs.com/hewei-blogs/p/15986452.html
