Maven 的安装与设置

Maven 是 流行的 Java 构建工具（Gradle 是后起之秀）。本文总结了开发中常用的 Windows 和 CentOS 环境下 Maven 的安装与基本配置。

作者：王克锋
出处：https://kefeng.wang/2016/10/15/maven-installation/
版权：自由转载-非商用-非衍生-保持署名，转载请标明作者和出处。

1 依赖环境

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

2 版本选择

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

发布日期	版本号	Java要求	发布说明	下载链接(zip)	下载链接(tgz)
2018-06-21	3.5.4	Java 7	release notes	apache-maven-3.5.4-bin.zip	apache-maven-3.5.4-bin.tar.gz
2015-11-14	3.3.9	Java 7	release notes	apache-maven-3.3.9-bin.zip	apache-maven-3.3.9-bin.tar.gz
2014-12-20	3.2.5	Java 6	release notes	apache-maven-3.2.5-bin.zip	apache-maven-3.2.5-bin.tar.gz
2013-10-04	3.1.1	Java 5	release notes	apache-maven-3.1.1-bin.zip	apache-maven-3.1.1-bin.tar.gz
2013-02-23	3.0.5	Java 5	release notes	apache-maven-3.0.5-bin.zip	apache-maven-3.0.5-bin.tar.gz

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 用户共用同一份本地仓库。

<!-- notepad %MAVEN_HOME%\conf\settings.xml -->
<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 用户共用同一份本地仓库。

<!-- sudo vim $MAVEN_HOME/conf/settings.xml -->
<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：仍未解决时可从本地仓库中删除相应目录再试，以便重新下载