idea新手配置和搭建maven工程（包含一些问题解决方案）

针对本文的一些简单说明：
许多新手在初次配置maven工程的时候，未必能一次配置成功，我在配置maven工程的时候曾遇到 maven仓库配置不正确， 默认镜像无法远程下载依赖包， 包无法引入等问题，写此博文旨在记录maven配置过程的同时给一些初次接触maven的小伙伴一个指南。

1.我的开发环境

JDK：Java11
idea版本：2020.2.3
maven版本：3.6.3

JDK可到Oracle官网下载：https://www.oracle.com/java/technologies/javase-downloads.html
idea可到jetbrains官网下载：
https://www.jetbrains.com/idea/
maven可到apache.org下载：
http://maven.apache.org/

关于jdk安装和环境变量配置,idea的安装,网络上有很多参考文章，也比较简单，本文重点介绍maven的安装和配置

2.maven下载和配置

安装idea其实是自带maven的，并且会将maven的设置文件（settings.xml）和本地仓库(repository)默认放到C盘用户文件夹下的.m2文件中。可以在idea的File | Settings | Build, Execution, Deployment | Build Tools | Maven中看到安装时默认的设置文件和仓库的位置。

我并没有采取默认的maven版本和设置，因为一是自带的不是最新的版本，二来远程下载依赖占用C盘空间，三则放在自己设置的位置方便以后对不同版本的maven统一管理。

2.1 maven下载和基本配置

下载下来的maven是个压缩包

选择maven压缩包

我解压到了D盘，进入maven文件夹可以看到里面的文件结构，到此下载环节就结束了，开始配置环境变量：

右击桌面的“我的电脑”，选择属性，左侧找到高级系统设置，找到环境变量

新建系统变量：
MAVEN_HOME：你的maven包解压路径（到bin上一级）（我是在D盘）

然后选择系统变量中的Path，加入%MAVEN_HOME%\bin

接下来验证是否成功：
Windows键+R
输入cmd进入控制台
在控制台输入 :mvn -v
如果出现版本信息即成功，见下图

至此maven下载和配置环境变量结束。

2.2 maven的settings.xml配置

在apache-maven-x.x.x文件夹下有个conf文件，下面找到settings.xml

解除localRepository标签，注释已说明这是你的本地仓库位置，这个可由你自己设置位置（创建个名为repository文件夹），本地仓库是maven远程下载依赖包存放的位置。

由于maven远程下载包都是从境外仓库下载的，所以创建maven工程后不是漫长的等待就是各种依赖无法加载，这会阻碍我们学习工作的进度。这时候就要配置一下可用的镜像地址，在settings.xml下找到mirrors标签，将以下镜像拷贝到mirrors标签中。(中央仓库访问在2020年初改为了https访问)

<!-- 阿里云仓库 -->
        <mirror>
            <id>alimaven</id>
            <mirrorOf>central</mirrorOf>
            <name>aliyun maven</name>
            <url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
        </mirror>

        <!-- 中央仓库1 -->
        <mirror>
            <id>repo1</id>
            <mirrorOf>central</mirrorOf>
            <name>Human Readable Name for this Mirror.</name>
            <url>https://repo1.maven.org/maven2/</url>
        </mirror>

2.3 idea中的maven全局设置

idea进行全局设置的时候需要关闭所有工程，在以下主界面右下角
Configuration的settings设置（全局设置是为了以后凡是创建maven工程都自动采用这个设置）

找到左侧maven，不要勾选work offline.
下面的maven目录是MAVEN_HOME的路径
settings是2.2配置的xml文件的路径
本地仓库自己定义位置（这里我直接把repository文件夹建在D盘下了）

还是在这个设置页面选择Importing，这里我们配置一个HTTPs访问获取依赖包的免SSL认证，目的是为了能实现成功远程导入我们的依赖包。

-Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true

其他方面可以默认，当然也要注意使用的JDK和你的版本匹配。

3 idea创建maven工程

（1）打开idea，创建工程

（1）选中maven
（2）选择你需要的jdk版本
（3）下一步
注：黄色框中是说你可以选择一个项目模板来方便开发（不是必须的而是根据开发需要，这里我们是试验一个maven能否搭建成功，而且你可以自己搭建maven工程，之后配置相应的框架）

给你的项目取一个名字
GroupId:这个是你公司或者组织的网址“逆序”
比如http://maven.apache.org/ 就是org.apache.maven
然后，点击finish创建工程
根据机器性能和网络质量，需要等待的时间是不同的
我们可以点开右侧maven（黄框）查看远程下载到仓库的各种包（如果下载不成功，无法加载依赖则会在有问题的包下出现红色下滑曲线）
正常配置成功，不会显示红线并且下方build有个绿色对勾，代表同步成功！

至此，一个空maven工程配置和搭建成功，我们接下来可以按照需要搭建框架进行软件开发。

4 配置maven的一些问题和解决办法

4.1 idea的maven无法修改目录位置或者修改后又变回原样

解决办法：首先在全局下设置，不在全局下，只能是对当前项目设置，新建的项目还会执行默认的全局设置，在全局设置时点击Override，才可以改成自己的位置。

4.2 idea建立maven工程出现无法下载依赖包，build中报红字,说无法从某镜像地址下载某包

解决办法：如果本地maven成功安装，idea中maven目录、设置文件、仓库等路径配置正确，那么这种情况就是所使用镜像无法访问导致。
两步：
（1）修改镜像，参见本文：2.2 maven的settings.xml配置，改成阿里云和https协议的中央仓库镜像；
（2）参考2.3 idea中的maven全局设置,在maven的Importing下Vm options for importer对话框中加入免SSL认证
（3）在本地仓repository中找到下载失败的包删除，回到idea双击clean
（4）点击左上角reload按钮重试

4.3 能远程下载部分依赖包，有些包无法下载，在右侧maven依赖包栏中有的报红，多次尝试reload也无果

解决办法：部分可以下载，说明确实可以访问镜像站获得所需包，此情况可能受网络因素影响，如果网络不佳请检查或更换网络后，点击reload按钮（4.2中所说按钮）；另外，加载过程中有的包没成功下载，但是这个包的文件夹已经建立了（有文件夹但是里面没能下到包），那么每当我们reload，会检查repository中是否已经有包，当检查到文件夹存在，就不下载，无论怎么尝试也不行，此时需要我们手动在repository中删除没有包的文件路径，然后执行clean和reload（4.2的(3)(4)步）。

4.4 已经成功下载依赖并且可以调用包中的类，但是maven包管理中的包报下滑红曲线

解决办法：在pom.xml中先将这个依赖的标签注释掉，等一下，再取消对其注释，然后reload即可。

结语

希望这个帖子可以帮助正在使用idea进行学习和软件开发的小伙伴，也欢迎各位同学在评论区发表自己的建议或者指正不足！