关于Maven最详细的安装配置教程

这几天一直有很多用户问我怎么去配置maven本地环境,相对应的也要配置到本地仓库。当然在IDEA中和很多程序的搭建中也会用到,以下教程可以参考使用!建议在本地电脑上常备好这个环境。

简介:Apache Maven是一个(特别是Java编程)项目管理及自动构建工具,由Apache软件基金会所提供。基于项目对象模型(缩写:POM)概念,Maven利用一个中央信息片断能管理一个项目的构建、报告和文档等步骤。

环境:

  • Maven:Apache Maven 3.8.4
  • Jdk环境:Jdk1.8.0_321
  • Idea版本:2021.2.3
  • 系统版本:Win11

第一部、安装

Apache官网(官方已经更新到3.86了)下载需要的版本,然后解压缩,解压路径尽量不要有空格和中文,如果官网访问比较慢,也可以下方直接保存下载。

Apache官网:maven.apache.org

Apache Maven 3.8.4

提取码:无
解压码:无

95e21c9b3e1b802b6bbe92100879e71e-e1660824346840

第二步、配置环境变量

①新建系统变量

变量名:MAVEN_HOME

值:你解压的路径  例:D:xxxapache-maven-3.8.4

71532eae30061baa4964037c957d4db2

②编辑系统变量Path

打开 -> 新建 -> 路径为:
%MAVEN_HOME%bin

f4e6ebe1bd18cb57139a6b512e94b619

③测试是否配置成功

cmd 窗口运行命令: mvn -v

出现安装版本号,安装路径,系统版本等信息表示安装成功
e9acd1d4ffb471a458893ea4be70fa84

第三步、配置本地仓库

在系统较大的盘符里新建一个文件夹 repository。

各位可以根据自己的电脑磁盘空间进行选择盘符创建,这里我就直接放到maven目录下了

d54882b66ac87567a7580dceaf9bb790-e1660825108718

然后打开maven解压目录下的settings文件。

例如我的安装路径:D:DevelopmentToolsMavenapache-maven-3.8.4conf

打开settings.xml文件,可以使用记事本或者其他文本编辑软件打开,这里我使用的是Notepad++软件打开

02444c2d5c7bcb729ba2640db8598e38-e1660825267243

打开之后长这个样子

81eab3177df0059e0d4a4ee9f0c59f01

然后我们找到 <localRepository>/path/to/local/repo</localRepository> 这个标签

a63eb16dfd1ac4a6a1c26129bb40a476

复制一个到下面,写上我们上面创建的本地仓库路径,例如我的路径在这里:

<localRepository>D:/DevelopmentTools/Maven/repository</localRepository>

7b255f6f79f105cf2c14e2099a32c0c8

第四步、配置远程仓库地址

这里先说下为什么我们要配置远程仓库地址。

Maven默认的远程仓库地址是:mvnrepository.com

这个仓库的服务器在国外,所以我们有时候下载依赖的时候因为网络延迟或者网络差会导致下载依赖不成功,缓慢等问题。所以我这里推荐配置国内阿里云的仓库地址

阿里云云效 Maven仓库:developer.aliyun.com

我们找到 <mirrors></mirrors>标签,在里面复制一个子标签到下面

5050c4265a6323319498829b86ccff38

可以根据上面阿里云仓库官网自己选择配置的仓库,这里我选择的是公共仓库

<mirror>  
     <id>alimaven</id>  
     <name>aliyun maven</name>  
     <url>http://maven.aliyun.com/nexus/content/groups/public/</url>  
     <mirrorOf>central</mirrorOf>        
</mirror>

第五步、配置maven编译环境

接着在找到 <profiles></profiles> 标签,在最下面配置上maven编译环境、jdk环境等配置

c3caee983a46deb8d3d93d7293fbe507-e1660826601972

复制代码在这里

<profile>
     <id>jdk-dev</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>

然后 ctrl+s保存settings.xml文件并退出。

第六步、在idea里配置maven环境

打开idea配置全局设置。

2cd1fd7ab73d9ed1c6736405f116dcd6-e1660826402991

2502bcdcc95edbb04a1b6e53ba62adec-e1660826413956

3e43e68e6837cbf08b25e8eadfa5965a-e1660826423562

0011fca32f8fe07af5110d4a1ad5a258-e1660826435616

下面的本地仓库地址会自动改变。因为我们在settings.xml文件中已经配置过了,它会自动读取我们的配置。

接着 应用–> 保存 就ok了

到这里maven的安装配置就已经结束了。

大家可以创建一个maven项目测试了。

第七步、idea创建maven项目测试

2e5886fb84e8703d5ab3d61dec613c05-e1660826481315

e3935579c39e8eecac0785560f40e018-e1660826494743

这样我们就创建好了。右下角的进度条可能第一次创建会比较慢,他会下载一些插件和依赖,等待一下就好了。

67a61e7ab53b3a090862f0ac110d4c29-e1660826511563

八、遇到网络不好或者依赖下载失败该怎么办

我相信大家在使用maven的时候,偶尔会遇到一些依赖下载报错,他产生的原因就是在下载本地仓库所没有的依赖时,因为外部原因(网络差或者断网、网络延迟高)等问题,下载失败了。然后我们再次刷新的时候maven就会报错,说找不到这个依赖。这里我提供一个小工具给大家解决这个问题。
大家在桌面上新建一个文本文件,写上下面的代码

@echo off
rem -- D:Mavenmaven-repository 你的库存地址
set REPOSITORY_PATH=D:DevelopmentToolsMavenrepository
rem -- 正在搜索...
for /f "delims=" %%i in ('dir /b /s "%REPOSITORY_PATH%*lastUpdated*"') do (
    del /s /q %%i
)
echo Deleted Successfully.
rem 搜索完毕
pause

记得 这里的rem — D:Mavenmaven-repository 你的库存地址 仓库地址要改成自己的本地仓库地址。然后保存,重命名将txt文件类型改成.bat文件类型。

397c9f450bf24c514c36f58c6f744f80-e1660826524659

接着执行这个文件,然后再次刷新maven依赖进行下载。

杂七杂八

子比主题在经典编辑器下的短代码使用教程

2022-8-31 15:06:27

杂七杂八

BBANK交易所搭建常见问题解决方法

2022-9-21 12:14:33