maven应该是java程序员最常用的一个工具了，也因为他的工具性，很多人并不很在意maven如何配置，更别说原理了，只要能用就可以了。这种状况在有新员工入职时尤其明显：

小鲜肉：我这个包怎么下不下来啊？
老腊肉：别着急，我给你拷份配置文件。
小鲜肉：怎么还是有下不下来的？
老腊肉：哦哦哦，我忘记了还有没传到私服的，我给你拷一份我本地仓库的。

过程虽然麻烦，但一旦配置好很多人又忘记了当时的问题。
所以就整理了一下maven setting文件该如何配置。

本文使用的maven版本为3.5.4

配置

首先maven setting可以被声明为两个级别：

• 用户级别。默认在${user.home}/.m2/settings.xml。可以通过命令行-s /path/to/user/settings.xml修改。
• 全局级别。默认在${maven.conf}/settings.xml。可以通过命令行-gs /path/to/global/settings.xml修改。

下面对配置中的每一个元素进行说明。

localRepository

本地仓库地址，默认值${user.home}/.m2/repository。

如果复制了别人的setting，也要注意下这个值和原来的是否相同，不然又要重下一遍。

interactiveMode

是否需要和用户输入进行交互。如果为false，则会使用合理的默认值。默认为true。

这个配置没怎么使用过，可以通过创建工程的命令对比下：

如果为false，命令如下

mvn archetype:generate -DgroupId=com.zworks -DartifactId=maven-setting -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

需要指定groupId、artifactId、archetypeArtifactId，如果不指定会报错，因为这些是无法推测出值的。

如果为true，命令如下

mvn archetype:generate

后面会让你选择或输入archetype、groupId、artifactId、version、package、为false的时候之所以不用指定version和package是因为这两个都有默认值。

offline

是否使用离线模式，默认值为false，这个应该不会设置成true的，要用通过命令行-o指定就可以了。

pluginGroups

如果plugin没有指定groupId，会从设置的这些里查找。默认会有org.apache.maven.plugins和org.codehaus.mojo。

比如，有了如下配置

<pluginGroups>
    <pluginGroup>
        org.mortbay.jetty
    </pluginGroup>
</pluginGroups>

就可以通过mvn jetty run替代长命令mvn org.mortbay.jetty:jetty-maven-plugin:run

proxies

代理配置，可以配置多个，如果没有指定会使用第一个激活的配置。

可配置的属性

servers

用于认证，支持两种方式

• 密码
• privateKey

比如公司搭建了一个私服，上传和下载需要认证，就需要在这里配置。

id需要与repository/mirror中的id相对应

使用密码

<server>
    <id>deploymentRepo</id>
    <username>repouser</username>
    <password>repopwd</password>
</server>

使用privateKey

<server>
    <id>siteServer</id>
    <privateKey>/path/to/private/key</privateKey>
    <passphrase>optional; leave empty if not used.</passphrase>
</server>

mirrors

仓库的镜像，如果仓库配置了镜像，就会去镜像中下载。

mirrorOf

• *匹配所有的仓库
• external:*匹配所有远程仓库，使用localhost的除外，使用file://协议的除外。也就是说，匹配所有不在本机上的远程仓库。
• 多个仓库可以使用英文逗号分隔
• 使用感叹号排除指定的仓库

举例：

repo,repo1匹配repo 或者 repo1

*,!repo1匹配除了repo1的所有

在匹配的时候，会先找精确匹配的，如果没有用第一个匹配的。

layout

layout在Maven 2/3中都是default，只有在Maven 1.x中才是legacy，所以也不太用管。

legacy的目录结构

  groupId
  |--artifactId
     |--jars
        `--artifact

default的目录结构

  groupId
  |--artifactId
     |--version
     |  `---artifact
     |---metadata

配置国内镜像

<mirror>
    <id>alimaven</id>
    <name>aliyun maven</name>
    <url>https://maven.aliyun.com/repository/central</url>
    <mirrorOf>central</mirrorOf>
</mirror>

profiles

setting中的profile主要为了提供本地的路径以及定义构建中要使用到的仓库。

profile in setting VS profile in pom

setting中的profile一般存放的是不太会变且不会影响构建过程的元素，对全局都影响。

pom中的profile有更多的设置项，但是影响范围只有自身以及子模块。

profile的激活方式

• 通过setting中的activeProfiles指定。
• 检测操作系统信息是否匹配。
• 检查环境变量是否匹配。
• 检测文件是否存在。
• 检测JDK版本是否匹配。
• 通过命令行-P指定。

activation

profile的激活条件，满足条件则激活。

jdk

• 前缀匹配，比如1.8能匹配jdk1.8.0_181
• [1.5,1.8)能匹配1.5、1.6、1.7，语法具体可以参看Version Range Specification

ActivationOS

ActivationProperty

ActivationFile

repository

这里是经常需要修改的地方，公司里一般都有自己的私服，就需要把相应的仓库加进来。就是因为仓库没配置，才会有一些包下不下来。

RepositoryPolicy

pluginRepository

插件仓库，配置的值和repository是一样的。

activeProfiles

激活的配置，可以配置多个。

<activeProfiles>
    <activeProfile>alwaysActiveProfile</activeProfile>
    <activeProfile>anotherAlwaysActiveProfile</activeProfile>
</activeProfiles>

看到了这里一定是真爱了，关注微信公众号【憨憨的春天】第一时间获取更新

参考

• maven setting 官方文档
• Maven Create Java Project – Interactive vs Non-interactive modes
• Maven settings.xml配置解读
• Deploy an artifact in legacy layout
• Using Mirrors for Repositories
• Introduction to Build Profiles