阅读GitHub源码的正确打开方式

前言

　　近来发现阅读开源项目上手就整最新的代码不合适，缺少项目迭代的具体实现过程，想着若是可以看到针对问题的提交代码就好了，所以就有了本篇博客。

　　以文主要涉及：如何fork开源项目，如何保证本地仓库代码更新到最新版本。

　　本文以开源项目Flink为例进行说明。

1、整体流程

　　fork项目  =====>  下载本地 ======>  导入IDEA  ， 配置git获取代码提交过程 =====>更新代码

2、fork项目

　　为了fork GitHub上的开源项目，首先需要一个GitHub的账号，注册过程可以百度，这里不详细展开。

　　在GitHub上找到所需的开源项目，点击右上角的fork，会自动地在自己的GitHub上创建一个repository，具体如下：

3、下载代码

　　为了获取contributer的提交过程，这里使用建议使用git在自己的仓库里获取源码。

　　直接在git clone 原项目的URL也是可以，但是若是你想贡献代码到原项目了？直接提代码到原开源项目上去提肯定不行的（当然也不是一定不行，仅说一般情况）。提交代码到原项目上的流程一般是：提交代码到个人的GitHub仓库，然后new pull request到原项目仓库，到时候原项目的作者就会根据情况是否合并你的代码。

　　获取URL的过程如下图：

　　小技巧：若是你直接从GitHub上下载源码速度慢，恰巧你是用的笔记本，你可以使用热点下载，速度惊人，就是不知道是为什么。

 4、导入IDEA，配置git获取提交过程

　　因为Flink是maven项目，所以导入过程只需要在IDEA中选择“导入已存在项目”，选中pom.xml文件即可。

　　该过程涉及以下几点：

　　1）Java版本的选择

　　　　正规的开源项目都会说明所适合的JDK版本，一般在GitHub项目下面的README.md文件或项目的wiki上；

　　　　所需的scala版本、maven同理；

　　2）配置git

　　　　配置过程可百度。

　　效果图如下：

 5、更新代码

　　以便了解项目的进展，可以采取如下步骤更新本地代码：

　　1）配置原项目地址

git remote add upstream <原仓库github地址>     //如：https://github.com/apache/flink.git

  　　2）查看当前仓库的远程仓库地址和原仓库地址

git remote -v

　　3）获取原仓库的更新

git fetch upstream

　　4）合并到本地分支

git merge upstream/master

　　5）查看本地更新

git log

　　6）更新自己fork 的GitHub仓库

git push origin master

 　　本地代码更新的还可以先更新GitHub上的仓库，然后在使用git pull更新本地仓库，但是这种方法我在使用过程遇到了无法获取最新的版本分支的情况，具体过程可以参考Ref[1]。

　　个人建议使用本文提及的以git命令方式更新。

　　此外，在使用git从GitHub上拉代码的过程，可能遇到RPC failed问题，可以参考Ref[2]。

6、异常处理

　　1） unable to access 'https://github.com/apache/flink.git/': OpenSSL SSL_read: SSL_ERROR_SYSCALL, errno 10054

　　解决办法：git config --global http.sslVerify "false"

Ref：

[1] https://www.cnblogs.com/eyunhua/p/8463200.html

[2]https://www.cnblogs.com/zjfjava/p/10392150.html