GitHub贡献代码实战

本文授权转载自公众号「良许Linux」。良许目前就职于一家世界500强外企,专注于Linux应用开发。他的公众号主要分享Linux方面干货,欢迎关注!


码农朋友们都知道,gitHub是一个面向开源及私有软件项目的托管平台,上面托管了众多的优秀的项目,比如linux内核源码、git源码、机器学习框架tensorflow等等。当然,除了这些顶尖项目外,还有海量的高手开发的优秀项目。所有的这些项目,我们都可以为它贡献代码。


那么,要如何为这些项目贡献代码呢?我们下面以实例来讲解。


比如说,现在gitHub上有个很牛逼的项目githubTest,它的作者是Alvin,项目地址如下:



https://github.com/yychuyu/githubTest



640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1


现在Harry看到了这个项目,想要对它进行贡献代码。想要达到这个目的,Harry要完成下图的这些步骤:

640?wx_fmt=jpeg&wxfrom=5&wx_lazy=1&wx_co=1

1. fork


Harry在找到这个项目之后,点击右上角的「fork」按钮。稍等片刻后,就会在Harry的账号下克隆了一个一样的项目githubTest,包括文件,提交历史,issues,和其余一些东西。


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1

2. clone


通过fork之后,Harry的账号下也有了githubTest这个项目,但还不能对它进行编译、修改(其实是可以修改,但是不建议)。


这时,可以通过git clone命令,将这个项目clone到自己的电脑里。


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1

3. update a file & 4. commit


接下来,Harry就可以大显身手了,可以自由对这个项目进行修改。但是,不建议在master分支直接修改,建议在master分支基础上切出一个dev分支,然后在dev分支上自由发挥。修改完之后,再将dev分支merge到master分支。


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1

5. push


在自己的电脑上修改好代码之后,再使用git push命令将改动同步到自己的gitHub项目仓库里。


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1

通过这个操作后,就可以在代码仓库里看到自己的提交了。


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1

6. pull request


接下来,就是向原作者Alvin提交你的代码了。首先点击文件列表上的「New pull request」。


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1



之后,gitHub会自动对源仓库分支及自己仓库分支代码进行比对,看看是否有冲突。如果它显示「Able to merge」的话,Harry就可以点击下面的「Create pull request」绿色按钮,进行代码提交。


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1


再之后,系统会要求你写一段注释,其实也可不写。但最好写一下,跟作者说明一下你改动了什么,为啥这么改。


通过以上6步,原作者Alvin就会收到一个pull request,如下图:


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1


然后,Alvin可以点进去,看看Harry具体提交了一些什么修改。如果他觉得这个修改确实够niubility的话,它就可以点击「merge pull request」,将Harry的提交集成到自己的项目里。


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1

640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1


至此,功德圆满,Harry顺利完成一次对项目githubTest的代码贡献。



640?wx_fmt=gif&wxfrom=5&wx_lazy=1



但是,这个项目实在太出众了,很多高手看到了并贡献了众多代码。比如现在Alvin自己提交了一个文件:


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1

现在原作者项目已经发生了改变,那Harry账号下的githubTest如何与原作者Alvin的项目保持同步呢?Harry需要做以下三步操作:

640?wx_fmt=jpeg&wxfrom=5&wx_lazy=1&wx_co=1

1. fetch


现在代码不同步了,我们要先把Alvin仓库的代码fetch到自己电脑的仓库下。注意,这是在自己电脑上操作,不是在github上操作。



git fetch git@github.com:yychuyu/githubTest.git master:latest



上面这条命令,git fetch 之后 的那部分,是原作者Alvin项目git地址,通过点击原项目「clone or download」按钮可以看到。再之后master:latest这部分,master是原项目分支,latest是自己项目分支。如果latest分支不存在的话,将自动创建。其实也可以将代码fetch到自己的master分支,但也不建议这么做。


2. merge


代码fetch到latest分支之后,再切到master分支,再使用git merge命令将最新代码合并到master分支。


3. push


现在,Harry电脑上的代码与原项目代码保持同步了。我们再使用git push命令,就可以将最新代码推到Harry账号下githubTest项目里


以上的三个步骤具体操作过程如下图示。


640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1

接下来,Harry就可以在此基础上,继续贡献自己的代码了。


陛下...看完奏折,点个赞再走吧!


推荐阅读


技术:jenkins和docker实现自动化构建部署

技术:设计图都不会画,还想做”架构师“?

技术:玩转linux 这些命令就够了 

技术:Kafka、RabbitMQ、RocketMQ等消息中间件的对比

技术:玩转linux 这些命令就够了

技术:30分钟如何学会使用Shiro 


工具:如何通过技术手段 “干掉” 视频APP里讨厌广告?

工具:通过技术手段 “干掉” 视频APP里讨厌的广告之(腾讯视频)


博主11年java开发经验,现从事智能语音工作的研发,关注微信公众号与博主进行技术交流!更过干货资源等你来拿!

640?wx_fmt=jpeg


640?wx_fmt=png



猜你喜欢

转载自blog.csdn.net/mxw2552261/article/details/83112409