SpringBoot系列(3)：SpringBoot2.1.x源码阅读环境搭建详解

前言

闲来无事试着从GitHub上拉取SpringBoot源码。然鹅，在本地IDEA打开后，爆各种编译错误，各种问题。经过反复操作，现在总结一下SpringBoot源码环境搭建的实践，便于后期对于源码的学习。

Github上SpringBoot源码的开源地址：https://github.com/spring-projects/spring-boot

1、环境准备

项目/工具	版本
SpringBoot	2.1.x
maven	3.5.4
JDK	1.8.0
IDEA	2018.x

 2、Fork源码

这里，我们可以将Git上这个开源的SpringBoot源码项目Fork到自己的Github仓库里。这样，后期自己在上边做笔记，或者各种的测试都可以直接提交到个人的仓库上，随意造作。看截图红框，(1)Fork源码到本地仓库；(2)源码版本选择。

  3、Clone源码

将源码的Git地址复制到IDEA中，这里一定要确认已经安装了Maven3.5.0以上的版本，低版本在编译时，Maven插件会报错。

  4、配置maven镜像源

为了加速下载所有的依赖 jar 包，我们先找到E:\maven\apache-maven-3.5.4\conf\setting.xml这个文件，然后在mirrors标签里粘贴如下内容。

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

 注意：配置完maven镜像源目的是为了后边下载jar包，有时候会下载失败。

  5、修改spring-boot项目的pom.xml文件

这里我们先将未编译的源码放在IDEA中看一下，需要修改校验属性。注意，这里先不要在maven的配置中点击clean/install源码，会报错，所有的依赖包都是一片红线。

OK，先在属性标签中加入如下内容:

<disable.checks>true</disable.checks>

 源码的结构如下：

接下来，我们需要对拉下来的源码进行编译。 

  6、编译Spring-Boot源码

进入源码项目所在的根目录，准备编译。

注意：编译执行的过程有一下几种方式，本地所使用的Maven版本：apache-maven-3.5.4。

【方式1】使用mvn clean install 编译项目(跳过测试部分的内容进行编译)

mvn clean install -DskipTests -Pfast

【方式2】使用mvn clean install 编译项目

mvn -Dmaven.test.skip=true clean install

参数说明：

-Dmaven.test.skip=true：表示执行上边这条命令在打包过程中将会忽略testcase，因为源码编译耗时非常漫长，中间也可能会爆一堆异常Error。 

【方式3】使用 mvnwrapper 编译项目

先执行：

mvn -N io.takari:maven:wrapper

然后执行：

./mvnw clean install -DskipTests -Pfast

这里，我们采用方式1的指令跳过测试部分进行编译。第一次编译，耗时15min左右，如果编译成功，我们能够看到如下打印信息：

注意：

【1】上边的命令执行编译2.1.x以下版本源码是成功的，但是去编译2.2.x版本源码时一直编译不过，暂时没搞明白咋回事。

【2】配置完maven镜像源后，使用上边命令编译，有时候会下载/编译失败。出现异常就暴力点，直接将本地仓库删干净，重新编译即可。

  7、IDEA导入源码及测试

源码导入IDEA后，我们还需要测试一下，记得将IDEA的 Maven 版本选择3.5.4，JDK选8以上的。这里，并没有使用maven默认的仓库，所以勾选使用自定义安装的maven配置文件和本地仓库。

【1】选取项目里的一个单元测试运行一下启动程序。

这里，在spring-boot-tests项目中，随便选了spring-boot-launch-script-tests项目下的LaunchScriptTestApplication.java这个启动类。点击运行，看看启动效果。

可以看到，已经启动成功，说明我们的spring-boot源码已经编译成功。接下来，将创建一个demo项目测试一下。 

【2】创建一个子模块demo项目，引入编译的源码进行测试。

---

愿你就像早晨八九点钟的太阳，活力十足，永远年轻。