本文共 2397 字，大约阅读时间需要 7 分钟。

目录

官方文档：

一、配置级别

Maven的配置文件setting.xml有两种配置级别：用户级别和全局配置级别。

1、用户级别：User Level

用户级别的setting文件在${user.home}/.m2/settings.xml.

2、全局级别：Global Level

全局级别的setting文件存在Maven的解压安装目录下：D:\apache-maven-3.6.0\conf\settings.xml.

3、如果两者都存在，它们的内容将被合并，并且用户范围的配置优先。

二、顶层元素预览

三、各元素说明

1、单值配置

• localRepository：构建系统的本地存储库的路径，默认值为$ {user.home} /.m2 / repository。
• interactiveMode：交互模式，Maven是否应该尝试与用户输入交互，默认是true，如果不是false。
• offline：是否每次编译都去查找远程中心库， 如果此构建系统应以离线模式运行，则为true，默认为false。

2、PluginGroups插件组

这个元素包含了一系列pluginGroup元素，每个又包含了一个groupId。当一个plugin被使用，而它的groupId没有被提供的时候，这个列表将被搜索。这个列表自动的包含了org.apache.maven.plugins和org.codehaus.mojo。

3、proxies代理配置

代理配置，默认第一个proxy配置起效

       
          
     
      myproxy
           
     
      true
           
     
      http
           
     
      proxy.somewhere.com
           
     
      8080
           
     
      proxyuser
           
     
      somepassword
           
     
      *.google.com|ibiblio.org
         
      
   

• id：此代理的唯一标识符。这用于区分代理元素。
• active：如果此代理处于活动状态，则为true。这对于声明一组代理很有用，但一次只能有一个代理。
• protocol，host，port：protocol://host:port，独立元素。
• username，password：这些元素显示为一对，表示对此代理服务器进行身份验证所需的登录名和密码。
• nonProxyHosts：这是不应代理的主机列表。列表的分隔符是代理服务器的预期类型; 上面的示例是管道分隔的 - 逗号分隔也很常见。

4、servers服务器

用来下载和部署的仓库是用POM中的repositories和distributionManagement元素来定义的。但是某些配置例如username和password就不应该随着pom.xml来分配了。这种类型的信息应该保存在构建服务器中的settings.xml中。

       
          
     
      server001
           
     
      my_login
           
     
      my_password
           
     
      ${user.home}/.ssh/id_dsa
           
     
      some_passphrase
           
     
      664
           
     
      775
           
         
      
   

• id：这是与Maven尝试连接的存储库/镜像的id元素匹配的服务器的ID （不是要登录的用户的ID ）。
• username, password：这些元素显示为一对，表示对此服务器进行身份验证所需的登录名和密码。
• privateKey，passphrase：与前两个元素一样，如果需要，该对指定私钥的路径（默认为$ {user.home} / .ssh / id_dsa）和密码。该密码和密码的元素可能在将来被外部化，但现在他们必须设置在纯文本的settings.xml文件。
• filePermissions，directoryPermissions：在部署时创建存储库文件或目录时，这些是要使用的权限。每个的合法值是对应于* nix文件权限的三位数字，例如664或775。

注意：如果使用私钥登录服务器，请确保省略<password>元素。否则，密钥将被忽略。

5、镜像

       
          
     
      planetmirror.com
           
     
      PlanetMirror Australia
           
     
      http://downloads.planetmirror.com/pub/maven2
           
     
      central
         
      
   

• id, name: 此镜像的唯一标识符和用户友好名称。 id用于区分镜像元素，并在连接到镜像时从<servers>部分选择相应的凭据。
• url:此镜像的基本URL。构建系统将使用此URL连接到存储库而不是原始存储库URL。
• mirrorOf: 这是镜像的存储库的id。

转载地址：http://zvlci.baihongyu.com/