May 29, 2016 / Jason Wang

配置 Maven

1 Maven 配置文件

默认情况下, Maven 的配置文件为配置目录下的 settings.xml 文件。

Linux -– /etc/maven2/settings.xml
Windows –- {maven}\conf\settings.xml

可以通过修改此文件来配置 Maven 。

通常需要修改如下默认配置：

1) 本地仓库 (Local Repository)

Maven的本地仓库用来存储所有项目的依赖关系。第三方 jar 文件和其他文件会被 Maven下载到本地仓库。当建立一个 Maven 项目时，Maven 会将所有相关文件和依赖库下载存储在本地仓库中。

默认情况下，Maven 的本地仓库为 .m2 文件夹：

Linx -- ~/.m2/
Windows -- C:\Documents and Settings\{your-username}\.m2\

2) 远程镜像 (Mirror)

当遇到无法下载依赖库的情况时（被墙或速度慢），可以通过添加镜像来解决。

2 配置本地仓库

如果不想把仓库放在默认的系统盘中，可以修改 localRepository 配置。

在 settings.xml 文件中找到配置段：

<!-- localRepository
| The path to the local repository maven will use to store artifacts.
|
| Default: ~/.m2/repository
<localRepository>/path/to/local/repo</localRepository>
-->

去掉注释，将 /path/to/local/repo 修改为想要的目录即可。

3 添加远程镜像

在 settings.xml 文件中找到配置段：

<mirrors>
  <mirror>
    <id>mirrorId</id>
    <mirrorOf>repositoryId</mirrorOf>
    <name>Human Readable Name for this Mirror.</name>
    <url>http://my.repository.com/repo/path</url>
  </mirror>
</mirrors>

此配置是样板配置，在此段注释下按格式添加 Mirror 配置。

常用的镜像如下：

国内镜像

oschina.net

<mirror>
  <id>nexus-osc</id>
  <mirrorOf>*</mirrorOf>
  <name>Nexus osc</name>
  <url>http://maven.oschina.net/content/groups/public/</url>
</mirror>

net.cn

<mirror>
    <id>net-cn</id>
    <mirrorOf>central</mirrorOf>
    <name>Human Readable Name for this Mirror.</name>
    <url>http://maven.net.cn/content/groups/public/</url>   
</mirror>

国外镜像

ibiblio.org

<mirror>  
  <id>ibiblio</id>  
  <mirrorOf>central</mirrorOf>  
  <name>ibiblio Mirror of http://repo1.maven.org/maven2/</name>  
  <url>http://mirrors.ibiblio.org/pub/mirrors/maven2/</url>  
</mirror>

jboss

<mirror>  
  <id>jboss-public-repository-group</id>  
  <mirrorOf>central</mirrorOf>  
  <name>JBoss Public Repository Group</name>  
  <url>http://repository.jboss.org/nexus/content/groups/public</url>  
</mirror>

repo2

<mirror>
  <id>repo2</id>
  <mirrorOf>central</mirrorOf>
  <name>Human Readable Name for this Mirror.</name>
  <url>http://repo2.maven.org/maven2/</url>
</mirror>

uk.maven.org

<mirror>
  <id>ui</id>
  <mirrorOf>central</mirrorOf>
  <name>Human Readable Name for this Mirror.</name>
  <url>http://uk.maven.org/maven2/</url>
</mirror>

4 安装本地 jar 包

如果已经下载好的 jar 包，可以通过如下命令安装到 Maven 的本地仓库

1	mvn install:install-file -DgroupId=<groupId> -DartifactId=<artifactId> -Dversion=<version> -Dpackaging=jar -Dfile=/path/to/jar/file

参数说明：

-DgroupId= 包的 group Id

-DartifactId= 包的 artifact Id

-Dversion= 包的版本号

例如，安装已下载好的 myBatis 包：

1	mvn install:install-file -DgroupId=org.mybatis -DartifactId=mybatis -Dversion=3.4.0 -Dpackaging=jar -Dfile=mybatis-3.4.0.jar