Maven 的安装与设置

矫情吗；* 2022-05-19 08:18 157阅读 0赞

Maven 是 流行的 Java 构建工具（Gradle 是后起之秀）。本文总结了开发中常用的 Windows 和 CentOS 环境下 Maven 的安装与基本配置。  
  
**作者：**王克锋  
**出处：**[https://kefeng.wang/2016/10/15/maven-installation/][https_kefeng.wang_2016_10_15_maven-installation]  
**版权：**[自由转载-非商用-非衍生-保持署名][-_-_-]，转载请标明作者和出处。

## 1 依赖环境 ##

需要事先安装 JDK，详见文章：[Linux/Windows JDK 的安装][Linux_Windows JDK]

## 2 版本选择 ##

[http://maven.apache.org/download.cgi][http_maven.apache.org_download.cgi]  
[http://maven.apache.org/docs/history.html][http_maven.apache.org_docs_history.html]  
对于开发者，各版本功能差别很小，差别在于修复BUG。我们可选择最新版本：

<table> 
 <thead> 
  <tr> 
   <th>发布日期</th> 
   <th>版本号</th> 
   <th>Java要求</th> 
   <th>发布说明</th> 
   <th>下载链接(zip)</th> 
   <th>下载链接(tgz)</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>2018-06-21</td> 
   <td>3.5.4</td> 
   <td>Java 7</td> 
   <td><a href="http://maven.apache.org/docs/3.5.4/release-notes.html" rel="nofollow">release notes</a></td> 
   <td><a href="http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.5.4/binaries/apache-maven-3.5.4-bin.zip" rel="nofollow">apache-maven-3.5.4-bin.zip</a></td> 
   <td><a href="http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.5.4/binaries/apache-maven-3.5.4-bin.tar.gz" rel="nofollow">apache-maven-3.5.4-bin.tar.gz</a></td> 
  </tr> 
  <tr> 
   <td>2015-11-14</td> 
   <td>3.3.9</td> 
   <td>Java 7</td> 
   <td><a href="http://maven.apache.org/docs/3.3.9/release-notes.html" rel="nofollow">release notes</a></td> 
   <td><a href="http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.zip" rel="nofollow">apache-maven-3.3.9-bin.zip</a></td> 
   <td><a href="http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz" rel="nofollow">apache-maven-3.3.9-bin.tar.gz</a></td> 
  </tr> 
  <tr> 
   <td>2014-12-20</td> 
   <td>3.2.5</td> 
   <td>Java 6</td> 
   <td><a href="http://maven.apache.org/docs/3.2.5/release-notes.html" rel="nofollow">release notes</a></td> 
   <td><a href="http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.2.5/binaries/apache-maven-3.2.5-bin.zip" rel="nofollow">apache-maven-3.2.5-bin.zip</a></td> 
   <td><a href="http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.2.5/binaries/apache-maven-3.2.5-bin.tar.gz" rel="nofollow">apache-maven-3.2.5-bin.tar.gz</a></td> 
  </tr> 
  <tr> 
   <td>2013-10-04</td> 
   <td>3.1.1</td> 
   <td>Java 5</td> 
   <td><a href="http://maven.apache.org/docs/3.1.1/release-notes.html" rel="nofollow">release notes</a></td> 
   <td><a href="http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.1.1/binaries/apache-maven-3.1.1-bin.zip" rel="nofollow">apache-maven-3.1.1-bin.zip</a></td> 
   <td><a href="http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.1.1/binaries/apache-maven-3.1.1-bin.tar.gz" rel="nofollow">apache-maven-3.1.1-bin.tar.gz</a></td> 
  </tr> 
  <tr> 
   <td>2013-02-23</td> 
   <td>3.0.5</td> 
   <td>Java 5</td> 
   <td><a href="http://maven.apache.org/docs/3.0.5/release-notes.html" rel="nofollow">release notes</a></td> 
   <td><a href="http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.0.5/binaries/apache-maven-3.0.5-bin.zip" rel="nofollow">apache-maven-3.0.5-bin.zip</a></td> 
   <td><a href="http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.0.5/binaries/apache-maven-3.0.5-bin.tar.gz" rel="nofollow">apache-maven-3.0.5-bin.tar.gz</a></td> 
  </tr> 
 </tbody> 
</table>

## 3 Windows 环境 ##

要在 Windows 下搭建本机 Java 开发环境，必须安装 Maven。

### 3.1 下载与安装 ###

*  下载：[apache-maven-3.5.4-bin.zip][]
 *  解压至 D:\\Develop\\apache-maven-3.5.4

### 3.2 设置环境变量 ###

*  MAVEN\_HOME=D:\\Develop\\apache-maven-3.5.4
 *  PATH=%PATH%;%MAVEN\_HOME%\\bin

### 3.3 修改 settings.xml ###

指定 localRepository 为固定位置，以确保所有 Windows 用户共用同一份本地仓库。

<settings ...>
        <localRepository>D:\Develop\repository</localRepository>
    </settings>

## 4 CentOS 环境 ##

对于测试和线上环境，要想构建基于 Maven 的 Java 项目，就需要安装 Maven。

### 4.1 下载与安装 ###

wget http://mirrors.hust.edu.cn/apache/maven/maven-3/3.5.4/binaries/apache-maven-3.5.4-bin.tar.gz
    sudo tar -zxf apache-maven-3.5.4-bin.tar.gz -C /opt
    sudo chown -R root:root /opt/apache-maven-3.5.4
    sudo ln -sf /opt/apache-maven-3.5.4/bin/mvn /usr/bin/mvn

### 4.2 设置环境变量 ###

## sudo vim /etc/profile ## 所有用户有效
    export MAVEN_HOME=/opt/apache-maven-3.5.4
    export PATH=$PATH:$MAVEN_HOME/bin

### 4.3 修改 settings.xml ###

指定 localRepository 为固定位置，以确保所有 Linux 用户共用同一份本地仓库。

<settings ...>
        <localRepository>/home/admin/repository</localRepository>
    </settings>

## 5 常见报错处理 ##

### 5.1 找不到开发包 ###

报错信息：Failure to find com.google.code.javaparser:javaparser : jar:1.0.8  
解决办法1：先确认远程仓库中文件存在，若不存在则指定其他远程仓库，或者手工安装 JAR 包至本地仓库  
解决办法2：仍未解决时可从本地仓库中删除相应目录再试，以便重新下载

[https_kefeng.wang_2016_10_15_maven-installation]: https://kefeng.wang/2016/10/15/maven-installation/
[-_-_-]: https://creativecommons.org/licenses/by-nc-nd/3.0/deed.zh
[Linux_Windows JDK]: https://kefeng.wang/2016/10/13/jdk-installation/
[http_maven.apache.org_download.cgi]: http://maven.apache.org/download.cgi
[http_maven.apache.org_docs_history.html]: http://maven.apache.org/docs/history.html
[apache-maven-3.5.4-bin.zip]: http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.5.4/binaries/apache-maven-3.5.4-bin.zip