【Java】Maven安装、Eclipse配置以及相关错误解决集合

时间:2021-02-01 15:39:07

作者呕血总结,下面写的每一个错误我都遇过

· Maven安装

· Eclipse配置

· Maven安装

安装前请确保已经装有JDK。

一、 准备Maven程序包

到官网https://maven.apache.org/download.cgi下载最新版,请注意查看是否符合安装的要求(页面System Requirements处)

确认符合条件后可选择Binary zip包下载,目前最新版的Maven是3.5.4。(Source archive是源码包)

解压文件到你指定的目录,文件结构如图所示。

【Java】Maven安装、Eclipse配置以及相关错误解决集合

二、配置环境变量

Win10用户需要在系统变量区域进行配置。

新建

变量名:MAVEN_HOME

变量值:C:\Program Files\Apache\maven(以上文件所在的目录)

Path变量中增加一项

%MAVEN_HOME%\bin

三、 检查安装状况

win+R - cmd进入窗口输入mvn -v或mvn-version可得以下类似信息

C:\Users\MYPC>>mvn -v
Apache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe; 2018-06-18T02:33:14+08:00)
Maven home: C:\Program Files\Apache\maven\bin\..
Java version: 1.8.0_121, vendor: Oracle Corporation, runtime: C:\Program Files\Java\jdk1.8.0_121\jre
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

如正常显示,则安装完成。

四、配置本地仓库(Local Repository)

1. 新建文件夹,以此作为本地仓库位置。现在以我设定的为例。

D:\MavenRepositories

2. 修改settings.xml文件,文件位置位于

C:\Program Files\Apache\maven\conf

使用Notepad++,指定本地仓库位置

<localRepository>D:/MavenRepositories</localRepository>

3. 我建议在此步骤先不要用mvn help:system命令下载maven包,因为就算此前配置完全成功,这一部分仍然可能未知原因出错!当然你可先在CMD窗口里先尝试一下

mvn help:system

【Java】Maven安装、Eclipse配置以及相关错误解决集合

如果窗口末端显示文字BUILD SUCCESS,那么恭喜你,你已经幸运地完成一大半的任务了。对于运气不佳的同学(比如我!),就会出现以下问题,如结尾:

No plugin found for prefix 'help' in the current project and in the plugin groups...

(单引号内的单词会因为情况有所更改)

下载失败的原因:1. 配置文件settings.xml里指定的本地仓库地址有误;2. 网络问题无法下载(通常是因为土蔷的关系,你懂的)

所以接下来我们要在配置文件中添加镜像。

阿里云的速度其实不太行,我几乎把各位贴出的地址都试过一遍,update indexes都没法动起来,或者瞬间100%。以下是我试验过确实可行的镜像。(貌似是某位大佬在Nexus上架设的私服,具体操作未知)

在文件中添加如下内容,添加后再使用mvn help:system进行包的下载。

<mirrors>
<mirror>
<id>Nexus</id>
<name>Nexus Public Mirror</name>
<url>http://121.42.166.202:8081/nexus/content/groups/public</url>
<mirrorOf>central</mirrorOf>
</mirror>
<mirros>

同时增加以下内容。其中第一部分profile里的内容是确保每次新建Maven文件默认使用JDK1.8版本。

<profile>
  <id>jdk-1.8</id>
  <activation>
    <activeByDefault>true</activeByDefault>
    <jdk>1.8</jdk>
  </activation>
  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
  </properties>
</profile>

<profile>
  <id>dev</id>
  <repositories>
    <repository>
      <id>Nexus</id>
      <url>http://121.42.166.202:8081/nexus/content/groups/public</url>
      <releases>
        <enabled>true</enabled>
        <updatePolicy>always</updatePolicy>
        <checksumPolicy>warn</checksumPolicy>
      </releases>
      <snapshots>
        <enabled>true</enabled>
        <updatePolicy>never</updatePolicy>
        <checksumPolicy>fail</checksumPolicy>
       </snapshots>
    </repository>
  </repositories>

  <pluginRepositories>
    <pluginRepository>
      <id>Nexus</id>
      <url>http://121.42.166.202:8081/nexus/content/groups/public</url>
      <releases>
        <enabled>true</enabled>
        <checksumPolicy>warn</checksumPolicy>
      </releases>
      <snapshots>
        <enabled>true</enabled>
        <checksumPolicy>fail</checksumPolicy>
      </snapshots>
     </pluginRepository>
    </pluginRepositories>
    <properties> <environment.type>prod</environment.type> </properties>

</profile>

· Eclipse配置

步骤1:添加刚刚安装好的Maven

菜单栏Window - Preference - Maven - Installation - Add

【Java】Maven安装、Eclipse配置以及相关错误解决集合

然后返回刚才的界面,勾选刚刚指定的Maven

【Java】Maven安装、Eclipse配置以及相关错误解决集合

步骤2:指定你的个人仓库路径

Window - Preference - Maven - User Settings,把Global Settings和Local Settings都设置为上述修改的settings.xml的路径。如果Eclipse提示"Could not read settings.xml",原因如下:

1. 保存文件编码格式不为UTF-8;

2. settings.xml文件内容出现语法错误,通常是标签漏写了一项(开始标签或者结束标签)。可用浏览器模式打开xml文件,如果正确显示XML内容则无误,否则会提示错误的行数。

【Java】Maven安装、Eclipse配置以及相关错误解决集合

XML文件以浏览器模式阅读的图示

步骤3: 为你的Maven插件添加索引(添加依赖时就能在Eclipse里通过搜索直接获取包,而无需修改pom.xml文件)

点开Global Repository,选择Nexus,右击选上Full Index Enable,随后选择Rebuild Index,等待下载完成。

步骤4:勾选Download repository index updates on startup,否则可能在maven插件中无法通过搜索查到依赖

【Java】Maven安装、Eclipse配置以及相关错误解决集合

· 快速测试

新建Maven Project

【Java】Maven安装、Eclipse配置以及相关错误解决集合

新建完成后右键Maven-Add Dependency(下方的Artifact ID cannot be empty可以选择无视),即可通过搜索下载依赖包

【Java】Maven安装、Eclipse配置以及相关错误解决集合