【Java】Maven安装、Eclipse配置以及相关错误解决集合
作者呕血总结,下面写的每一个错误我都遇过
· Maven安装
· Eclipse配置
· Maven安装
安装前请确保已经装有JDK。
一、 准备Maven程序包
到官网https://maven.apache.org/download.cgi下载最新版,请注意查看是否符合安装的要求(页面System Requirements处)
确认符合条件后可选择Binary zip包下载,目前最新版的Maven是3.5.4。(Source archive是源码包)
解压文件到你指定的目录,文件结构如图所示。
二、配置环境变量
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
如果窗口末端显示文字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
然后返回刚才的界面,勾选刚刚指定的Maven
步骤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内容则无误,否则会提示错误的行数。
XML文件以浏览器模式阅读的图示
步骤3: 为你的Maven插件添加索引(添加依赖时就能在Eclipse里通过搜索直接获取包,而无需修改pom.xml文件)
点开Global Repository,选择Nexus,右击选上Full Index Enable,随后选择Rebuild Index,等待下载完成。
步骤4:勾选Download repository index updates on startup,否则可能在maven插件中无法通过搜索查到依赖
· 快速测试
新建Maven Project
新建完成后右键Maven-Add Dependency(下方的Artifact ID cannot be empty可以选择无视),即可通过搜索下载依赖包