settings.xml 配置详解
XML
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
<!-- 本地仓库配置，默认为 ${user.home}/.m2/repository -->
<localRepository>D:\maven\repository</localRepository>
<!-- 在pluginGroups元素下面可以定义一系列的pluginGroup元素。
表示当通过plugin的前缀来解析plugin的时候到哪里寻找。
pluginGroup元素指定的是plugin的groupId。默认情况下，Maven会自动把org.apache.maven.plugins
和 org.codehaus.mojo 添加到pluginGroups下。-->
<pluginGroups></pluginGroups>
<!-- 这个属性表示在Maven进行项目编译和部署等操作时是否允许Maven进行联网来下载所需要的信息。
如果构建系统需要在离线模式下运行，则为true，默认为false。
当由于网络设置原因或者安全因素，构建服务器不能连接远程仓库的时候，可使用该配置该配置。-->
<offline>false</offline>
<!-- 用来配置不同的代理。-->
<proxies>
<!--代理元素包含配置代理时需要的信息 -->
<proxy>
<!--代理的唯一定义符，用来区分不同的代理元素。 -->
<!-- <id>my_proxy</id> -->
<!--该代理是否是激活。true则激活代理，当声明了多组代理，
而只需要激活一个代理的时候，使用该元素控制。 -->
<!-- <active>true</active> -->
<!--代理的协议。 协议://主机名:端口，分隔成离散的元素以方便配置。 -->
<!-- <protocol>http</protocol> -->
<!--代理的主机名。协议://主机名:端口，分隔成离散的元素以方便配置。 -->
<!-- <host>proxy.somewhere.com</host> -->
<!--代理的端口。协议://主机名:端口，分隔成离散的元素以方便配置。 -->
<!-- <port>8080</port> -->
<!--代理的用户名，用户名和密码表示代理服务器认证的登录名和密码。 -->
<!-- <username>proxy_user</username> -->
<!--代理的密码，用户名和密码表示代理服务器认证的登录名和密码。 -->
<!-- <password>some_password</password> -->
<!--不该被代理的主机名列表。该列表的分隔符由代理服务器指定；如竖线，或逗号分隔。 -->
<!-- <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts> -->
</proxy>
</proxies>
<!-- 当仓库需要认证时，需要配置，server的id需要与repositories保持一致生效。
一般，仓库的下载和部署是在pom.xml文件中的repositories 和 distributionManagement 元素中定义的。
然而，一般类似用户名、密码（有些仓库访问是需要安全认证的）等信息不应该在pom.xml文件中配置，
这些信息可以配置在 settings.xml 中。
-->
<servers>
<server>
<!--这是server的id（注意不是用户登陆的id），
该id与distributionManagement中repository元素的id相匹配。 -->
<id>nexus</id>
<!--鉴权用户名。鉴权用户名和鉴权密码表示服务器认证所需要的登录名和密码。 -->
<username>admin</username>
<!--鉴权密码 。鉴权用户名和鉴权密码表示服务器认证所需要的登录名和密码。密码加密功能已被添加到2.1.0 +。
详情请访问密码加密页面 -->
<password>admin123</password>
<!-- 鉴权时使用的私钥位置。和前两个元素类似，私钥位置和私钥密码指定了一个私钥的路径
（默认是${user.home}/.ssh/id_dsa）以及如果需要的话，一个密语。
将来passphrase和password元素可能会被提取到外部，但目前它们必须在settings.xml文件以纯文本的形式声明。
-->
<!-- <privateKey>${usr.home}/.ssh/id_dsa</privateKey>-->
<!--鉴权时使用的私钥密码。 -->
<!-- <passphrase>some_passphrase</passphrase>-->
<!--文件被创建时的权限。如果在部署的时候会创建一个仓库文件或者目录，这时候就可以使用权限（permission）。
这两个元素合法的值是一个三位数字，其对应了unix文件系统的权限，如664，或者775。 -->
<!-- <filePermissions>664</filePermissions>-->
<!--目录被创建时的权限。 -->
<!-- <directoryPermissions>775</directoryPermissions>-->
</server>
</servers>
<!--
用于定义一系列的远程仓库的镜像。
注意是镜像，而不是"分库"，只有当前一个mirror无法连接的时候，才会去找后一个，类似于备份和容灾。
所以当第一个mirror中不存在a.jar的时候，并不会去第二个mirror中查找，甚至于，
maven根本不会去其他的mirror地址查询。
当有id为B,A,C的顺序的mirror在mirrors节点中，maven会根据字母排序来指定第一个，
所以不管怎么排列，一定会找到A这个mirror来进行查找，当A无法连接，出现意外的情况下，才会去B查询。
-->
<mirrors>
<mirror>
<!-- 该镜像的唯一标识符。id用来区分不同的mirror元素。 -->
<id>aliyunmaven</id>
<!-- 被镜像的服务器的id。例如，如果我们要设置了一个Maven中央仓库
（http://repo.maven.apache.org/maven2/）的镜像，就需要将该元素设置成central。
这必须和中央仓库的id central完全一致。 -->
<mirrorOf>*</mirrorOf>
<!-- 镜像名称 -->
<name>阿里云公共仓库</name>
<!-- 该镜像的URL。构建系统会优先考虑使用该URL，而非使用默认的服务器URL。 -->
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
<mirror>
<id>nexus-163</id>
<mirrorOf>*</mirrorOf>
<name>网易 Nexus 163</name>
<url>http://mirrors.163.com/maven/repository/maven-public/</url>
</mirror>
<mirror>
<id>nexus-tencentyun</id>
<mirrorOf>*</mirrorOf>
<name>Nexus tencentyun</name>
<url>http://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
</mirror>
</mirrors>
<!-- 根据环境参数来调整构建配置的列表。
settings.xml 中的 profile 元素是 pom.xml 中 profile 元素的裁剪版本。
它包含了id、activation、repositories、pluginRepositories 和 properties 元素。
这里的profile元素只包含这五个子元素是因为这里只关心构建系统这个整体（这正是settings.xml文件的角色定位），
而非单独的项目对象模型设置。
如果一个settings.xml中的profile被激活，它的值会覆盖任何其它定义在pom.xml中带有相同id的profile。
当所有的约束条件都满足的时候就会激活这个profile。
使用默认激活方式时<activeByDefault>true</activeByDefault>，只有在没有指定其他profile激活时才会生效。
激活的时候，若存在多个激活条件，多个条件是或的关系，即有一个条件满足就可以激活该profile。
-->
<profiles>
<!-- java1.8版本 -->
<profile>
<!-- profile的唯一标识 -->
<id>jdk-1.8</id>
<!-- 自动触发profile的条件逻辑 -->
<activation>
<!-- 当其值为true的时候表示如果没有其他的profile处于激活状态的时候，该profile将自动被激活。-->
<activeByDefault>true</activeByDefault>
<jdk>1.8</jdk>
</activation>
<!-- 扩展属性列表 -->
<!-- 用于定义属性键值对的。当该profile是激活状态的时候，properties下面指定的属性都可以在pom.xml中使用。 -->
<!--如果Maven检测到某一个属性（其值可以在POM中通过${name}引用），
其拥有对应的name = 值，Profile就会被激活。如果值字段是空的，那么存在属性名称字段就会激活profile，
否则按区分大小写方式匹配属性值字段 -->
<properties>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
</properties>
</profile>
<profile>
<id>nexus</id>
<!-- 远程仓库列表 -->
<!-- 用于定义远程仓库的，当该profile是激活状态的时候，这里面定义的远程仓库将作为当前pom的远程仓库。
它是maven用来填充构建系统本地仓库所使用的一组远程仓库。 -->
<repositories>
<!--包含需要连接到远程仓库的信息 -->
<repository>
<!--远程仓库唯一标识 -->
<id>maven-releases</id>
<!--远程仓库名称 -->
<name></name>
<url>http://maven-releases</url>
<!--如何处理远程仓库里发布版本的下载 -->
<releases>
<!--true或者false表示该仓库是否为下载某种类型构件（发布版，快照版）开启。 -->
<enabled>true</enabled>
<!--该元素指定更新发生的频率。Maven会比较本地POM和远程POM的时间戳。
这里的选项是：always（一直），daily（默认，每日），
interval：X（这里X是以分钟为单位的时间间隔），或者never（从不）。 -->
<updatePolicy>always</updatePolicy>
<!--当Maven验证构件校验文件失败时该怎么做-ignore（忽略），fail（失败），或者warn（警告）。 -->
<checksumPolicy>warn</checksumPolicy>
</releases>
<!--如何处理远程仓库里快照版本的下载。有了releases和snapshots这两组配置，POM就可以在每个单独的仓库中，
为每种类型的构件采取不同的策略。
例如，可能有人会决定只为开发目的开启对快照版本下载的支持。参见repositories/repository/releases元素 -->
<snapshots>
<enabled>true</enabled>
</snapshots>
<!--用于定位和排序构件的仓库布局类型-可以是default（默认）或者legacy（遗留）。
Maven 2为其仓库提供了一个默认的布局；然而，Maven 1.x有一种不同的布局。
我们可以使用该元素指定布局是default（默认）还是legacy（遗留）。 -->
<layout>default</layout>
</repository>
<repository>
<id>maven-snapshots</id>
<url>http://nexus-snapshots</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<!-- 插件仓库列表，maven插件的仓库从这里下载 -->
<pluginRepositories>
<pluginRepository>
<id>maven-releases</id>
<url>http://nexus-releases</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>maven-snapshots</id>
<url>http://maven-snapshots</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
<!-- 手动激活profiles的列表，按照profile被应用的顺序定义activeProfile。
该元素包含了一组activeProfile元素，每个activeProfile都含有一个profile id。
任何在activeProfile中定义的profile id，不论环境设置如何，其对应的 profile都会被激活。
如果没有匹配的profile，则什么都不会发生。
例如: env-test是一个activeProfile，则在pom.xml（或者profile.xml）中对应id的profile会被激活。
如果运行过程中找不到这样一个profile，Maven则会像往常一样运行。-->
<activeProfiles>
<!-- 要激活的profile id -->
<activeProfile>nexus</activeProfile>
</activeProfiles>
</settings>maven 拉取资源的优先顺序
java
<!--
基本优先级顺序：本地仓库 > settings.xml的profile的仓库 > pom.xml的profile的仓库 > pom.xml的仓库 > 中央仓库
如果仓库的id设置成"central"，则该仓库会覆盖maven默认的中央仓库配置
（这种情况会影响基本优先级，例如在setting.xml中配置了一个仓库，且id为"central"，此时这个仓库覆盖了中央仓库，但是优先级变为小于pom.xml的profile的仓库， 大于pom.xml的仓库）。
如果发现该仓库有镜像设置，则用镜像的地址代替，例如现在进行到要在respository A仓库中查找某个依赖，但A仓库配置了mirror，则会转到从A的mirror中查找该依赖，不会再从A中查找。
如果最终下载不到需要的资源，maven则会报错。
-->