写Java这么久，JDK源码编译过没？编译JDK源码踩坑纪实
好奇害死羊
很多小伙伴们做Java开发，天天写Java代码，肯定离不开Java基础环境：JDK，毕竟我们写好的Java代码也是跑在JVM虚拟机上。
一般来说，我们学Java之前，第一步就是安装JDK环境。这个简单啊，我们一般直接把JDK从官网下载下来，安装完成，配个环境变量就可以愉快地使用了。
不过话说回来，对于这个天天使用的东西，我们难道不好奇这玩意儿它到底是怎么由源码编译出来的吗？
带着这个原始的疑问，今天准备大干一场，自己动动呆萌的小手，来编译一个属于自己的JDK吧！
对了，本文在开源项目：https://github.com/hansonwang99/JavaCollection 中已收录，包含自学编程路线、面试题集合/面经、及系列技术文章等，资源持续更新中...
还有个待填的坑
记得之前不是出过一期关于《JDK源码阅读环境搭建》相关的视频以及文章嘛，细心的小伙伴，可能会发现一个很实际的问题：
我们将
src.zip包里的JDK源码解压出来，关联到这份源码之后，调试时是可以进，但是我们在加注释的时候却只能在行尾添加，并不能改变原代码的行结构。换句话说，如果在源码中加了跨行的多行注释，则debug调试的时候就会出现当前行的运行错位问题，这个有点尴尬了。
当然那个视频的评论区，的确也有几个小伙伴提了这个问题：
原因也很简单，因为实际支撑调试运行的代码，并不是我们解压出来的那份JDK源码，那个仅仅是做关联用，实际运行用到的JDK，还是之前系统安装好的那个JDK环境。
要想解决这个问题，那就只能使用自己修改过的代码来自行编译生成自己的JDK，然后用到项目中去！
所以什么都憋说了，肝就完了！
环境准备
首选说在前面的是，编译前的软件版本关系极其重要，自己在踩坑时，所出现的各种奇奇怪怪的问题几乎都和这个有关，后来版本匹配之后，就非常顺利了。
我们来盘点和梳理一下编译一个JDK需要哪些环境和工具：
1、boot JDK
我们要想编译JDK，首先自己本机必须提前已经安装有一个JDK，官方称之为bootstrap JDK（或者称为boot JDK）。
比如想编译JDK 8，那本机必须最起码得有一个JDK 7或者更新一点的版本；你想编译JDK 11，那就要求本机必须装有JDK 10或者11。
所以鸡生蛋、蛋生鸡又来了...
2、Unix环境
编译JDK需要Unix环境的支持！
这一点在Linux操作系统和macOS操作系统上已经天然的保证了，而对于Windows兄弟来说稍微麻烦一点，需要通过使用Cygwin或者MinGW/MSYS这种软件来模拟。
就像官方所说：在Linux平台编译JDK一般问题最少，容易成功；macOS次之；Windows上则需要稍微多花点精力，问题可能也多一些。
究其本质原因，还是因为Windows毕竟不是一个Unix-Like内核的系统，毕竟很多软件的原始编译都离不开Unix Toolkit，所以相对肯定要麻烦一些。
3、编译器/编译工具链
JDK底层源码（尤其JVM虚拟机部分）很多都是C++/C写的，所以相关编译器也跑不掉。
一图胜千言，各平台上的编译器支持如下表所示，按平台选择即可：
4、其他工具
典型的比如：
-
Autoconf：软件源码包的自动配置工具 -
Make：编译构建工具 -
freetype：一个免费的渲染库，JDK图形化部分的代码可能会用它
好，环境盘点就到这里，接下来具体列一下我在编译JDK 8和JDK 11时分别用到的软件详细版本信息：
编译JDK 8时：
-
操作系统：macOS 10.11.6 -
boot JDK：JDK 1.8.0 (build 1.8.0_201-b09) -
Xcode版本：8.2 -
编译器：Version 8.0.0 (at /usr/bin/clang)
编译JDK 11时：
-
操作系统：macOS 10.15.4 -
boot JDK：JDK 11.0.7 (build 11.0.7+8-LTS) -
Xcode版本：11.5 -
编译器：Version 11.0.3 (at /usr/bin/clang)
大家在编译时如果过程中有很多问题，大概率少软件没装，或者软件版本不匹配，不要轻易放弃，需要耐心自查一下。
下载JDK源码
下载JDK源码其实有两种方式。
方式一：通过Mercurial工具下载
Mercurial可以理解为和Git一样，是另外一种代码管理工具，安装好之后就有一个hg命令可用。
而OpenJDK的源码已经提前托管到http://hg.openjdk.java.net/。
因此，比如下载JDK 8，可直接hg clone一下就行，和git clone一样：
hg clone http://hg.openjdk.java.net/jdk8/jdk8
同理，下载JDK 11：
hg clone http://hg.openjdk.java.net/jdk/jdk11
但是这种方式下载速度不是很快。
方式二：直接下载打包好的源码包
下载地址：https://jdk.java.net/
选择你想要的版本下载即可。
编译前的自动配置
源码包下载好，放到本地某个目录（建议路径纯英文，避免不必要的麻烦），解压之，然后进入源码根目录，执行：
sh configure
当然这里运行的是默认配置项。
这一步会进行一系列的自动配置工作，时间一般很快，最终如果能出现一下提示，那么很幸运，编译前的配置工作就完成了！
这里我给出我自己分别在配置JDK 11和JDK 8时候完成时的样子：
配置JDK 8完成：
配置JDK 11完成：
注： 如果这一步出错，大概率是某个软件环境未装，或者即使装了，但版本不匹配，控制台打印日志里一般是会提醒的。
比如我在配置JDK 8的时候，就遇到了一个errof：GCC compiler is required的问题：
明明系统里已经有编译器，但还是报这个错误。通过后来修改 jdk源码根目录/common/autoconf/generated-configure.sh文件，将相关的两行代码注释后就配置通过了
配置完成，接下来开始执行真正的编译动作了！
真正的编译动作
我们这里进行的是全量编译，直接在我们下载的JDK源码根目录下执行如下命令即可：
make all
这一步编译需要一点时间，耐心等待一下即可。编译过程如果有错误，会终止编译，如果能看到如下两个画面，那么则恭喜你，自己编译JDK源码就已经通过了，可以搞一杯咖啡庆祝一下了。
JDK 8编译完成：
JDK 11编译完成：
从两张图的对比可以看出，编译JDK 8和JDK 11完成时在输出上还是有区别的。时间上的区别很大程度上来源于JDK 11的编译机配置要高不少。
验证成果
JDK源码编译完成之后肯定会产生和输出很多产物，这也是我们所迫不及待想看到的。
由于JDK 8和JDK 11的源码包组织结构并不一样，所以输出东西的内容和位置也有区别。我们一一来盘点一下。
1、JDK 8的编译输出
编译完成，build目录下会生成一个macosx-x86_64-normal-server-release目录，所有的编译成果均位于其中。
首先，编译出来的Java可执行程序可以在如下目录里找到：
jdk源码根目录/build/macosx-x86_64-normal-server-release/jdk/bin
进入该目录后，可以输入./java -version命令验证：
其次，编译生成的成品JDK套装，可以在目录
jdk源码根目录/build/macosx-x86_64-normal-server-release/images
下找到，如图所示：
其中：
-
j2sdk-image：编译生成的JDK -
j2re-image：编译生成的JRE
进入j2sdk-image目录会发现，里面的内容和我们平时从网络上下载的成品JDK内容一致。
2、JDK 11的编译输出
JDK 11的源码目录组织方式和JDK 8本身就有区别，编译生成的产物和上面编译JDK 8的输出有一定区别，但也不大。
JDK 11编译完成，同样在build目录下会生成一个macosx-x86_64-normal-server-release目录，所有的编译成果均位于其中。
同样编译出来的Java可执行程序可以在目录
JDK源码根目录/build/macosx-x86_64-normal-server-release/jdk/bin
下看到，进入该目录后，也可以输入./java -version命令验证：
其次，编译生成的成品JDK 11套装，可以在目录
JDK源码根目录/build/macosx-x86_64-normal-server-release/images
下找到，如图所示：
其中jdk目录就是编译生成的成品JDK 11套装。
使用自己编译的JDK
既然我们已经动手编译出了JDK成品，接下来我们得用上哇。
新建一个最最基本的Java工程，比如命名为JdkTest，目的是把我们自己编译出的JDK给用上。
我们点开Project Structure，选到SDKs选项，新添加上自己刚刚编译生成的JDK，并选为项目的JDK，看看是否能正常工作
点击确定之后，我们运行之：
可以看到我们自己编译出的JDK已经用上了。
关联JDK源码并修改
我们继续在上一步JdkTest项目的Project Structure → SDKs里将JDK源码关联到自行下载的JDK源码路径上：
这样方便我们对自己下载的JDK源码进行阅读、调试、修改、以及在源码里随意做笔记和加注释。
举个最简单的例子，比如我们打开System.out.println()这个函数的底层源码：
我们随便给它修改一下，加两行简单的标记，像这样：
为了使我们新加的代码行生效，我们必须要重新去JDK源码的根目录中再次执行 make images重新编译生成JDK方可生效：
因为之前已经全量编译过了，所以再次make的时候增量编译一般很快。
重新编译之后，我们再次运行JdkTest项目，就可以看到改动的效果了：
多行注释的问题
记得之前搭建《JDK源码阅读环境》时，大家可能发现了一个问题：阅读源码嘛，给源代码做点注释或笔记很常见！但那时候有个问题就是做注释时不可改变代码的行结构（只能行尾注释，不能跨行注释），否则debug调试时会出现行号错位的问题。
原因很简单，因为我们虽然做了源代码目录的映射，但是实际支撑运行的JDK还是预先安装好的那个JDK环境，并不是根据我们修改后的源码来重新编译构建的，所以看到这里，解决这个问题就很简单，就像上面一样自行编译一下JDK即可。
实际在实验时，还有一个很典型的问题是，当添加了多行的中文注释后，再编译居然会报错！
比如，还是以上面例子中最简单的System.out.println()源码为例，我们添加几行中文注释：
这时候我们去JDK源码目录下编译会发现满屏类似这样的报错：
错误: 编码 ascii 的不可映射字符
顿时有点懵，毕竟仅仅是加了几行注释。对于我们来说，源码里写点多行的中文注释基本是刚需，然而编译竟会报错，这还能不能让人愉快的玩耍了... 当时后背有点发凉。
实不相瞒，就这个问题排查了一段时间，熬到了很晚。最终折腾了一番，通过如下这种方式解决了，顺便分享给小伙伴们，大家如果遇到了这个问题，可以参考着解决一下。
因为从控制台的报错可以很明显的看出，肯定是字符编码相关的问题导致的，而且都指向了ascii这种编码方式。
于是将JDK的源码从根目录导入了Vs Code，然后全目录查找encoding ascii相关的内容，看看有没有什么端倪，结果发现
jdk源码根目录/make/common/SetupJavaCompilers.gmk文件中有两处指定了ascii相关的编码方式：
于是尝试将这两处-encoding ascii的均替换成-encoding utf-8：
然后再次执行make images编译，编译顺利通过！
至此大功告成！
这样后面不管是阅读、调试还是定制JDK源码都非常方便了。
后记：这篇文章在开源项目：https://github.com/hansonwang99/JavaCollection 中也已经收录了，包含自学编程路线、面试题集合/面经、及系列技术文章等，资源持续更新中...
每天进步一点点
慢一点才能更快
