GitHub 简单教程
<p>码农朋友们都知道，GitHub是一个面向开源及私有软件项目的托管平台，上面托管了众多的优秀的项目，比如Linux内核源码、Git源码、机器学习框架Tensorflow等等。当然，除了这些顶尖项目外，还有海量的高手开发的优秀项目。所有的这些项目，我们都可以为它贡献代码。</p><p>那么，要如何为这些项目贡献代码呢？我们下面以实例来讲解。</p>
<p>比如说，现在GitHub上有个很牛逼的项目githubTest，它的作者是Alvin，项目地址如下：https://github.com/yychuyu/githubTest。</p>
<p><img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619151815973-864095943.png"></p>
<p>现在Harry看到了这个项目，想要对它进行贡献代码。想要达到这个目的，Harry要完成下图的这些步骤：</p>
<p> <img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619151831851-1136096522.png"></p>
<p><strong>1. fork</strong></p>
<p>Harry在找到这个项目之后，点击右上角的「fork」按钮。稍等片刻后，就会在Harry的账号下克隆了一个一样的项目githubTest，包括文件、提交历史、issues、和其余一些东西。</p>
<p><img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619151911260-1544685401.png"></p>
<p><strong>2. clone</strong></p>
<p>通过fork之后，Harry的账号下也有了githubTest这个项目，但还不能对它进行编译、修改（其实是可以修改，但是不建议）。</p>
<p>这时，可以通过git clone命令，将这个项目clone到自己的电脑里。</p>
<p><img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619151926595-1178281482.png"></p>
<p><img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619151934351-1072820571.png"></p>
<p><strong>3. update a file & 4. commit</strong></p>
<p>接下来，Harry就可以大显身手了，可以自由对这个项目进行修改。</p>
<p>但是，不建议在master分支直接修改，建议在master分支基础上切出一个dev分支，然后在dev分支上自由发挥。修改完之后，再将dev分支merge到master分支。</p>
<p> <img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619151949254-200081229.png"></p>
<p><strong>5. push</strong></p>
<p>在自己的电脑上修改好代码之后，再使用git push命令将改动同步到自己的GitHub项目仓库里。<img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619152000163-1682741296.png"></p>
<p>通过这个操作后，就可以在代码仓库里看到自己的提交了。</p>
<p> <img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619152010057-1465801933.png"></p>
<p><strong>6. pull request</strong></p>
<p>接下来，就是向原作者Alvin提交你的代码了。首先点击文件列表上的「New pull request」。</p>
<p> <img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619152024226-729973991.png"></p>
<p>之后，GitHub会自动对源仓库分支及自己仓库分支代码进行比对，看看是否有冲突。如果它显示「Able to merge」的话，Harry就可以点击下面的「Create pull request」绿色按钮，进行代码提交。</p>
<p> <img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619152037296-99769466.png"></p>
<p><img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619152053302-1135968115.png"></p>
<p>再之后，系统会要求你写一段注释，其实也可不写。但最好写一下，跟作者说明一下你改动了什么，为什么这么改。</p>
<p>通过以上6步，原作者Alvin就会收到一个pull request，如下图：</p>
<p> <img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619152109254-635806479.png"></p>
<p>然后，Alvin可以点进去，看看Harry具体提交了一些什么修改。如果他觉得这个修改确实够niubility的话，它就可以点击「merge pull request」，将Harry的提交集成到自己的项目里。</p>
<p> <img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619152211583-491950894.png"></p>
<p> </p>
<p><img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619152120532-1216766905.png"></p>
<p>至此，功德圆满，Harry顺利完成一次对项目githubTest的代码贡献。</p>
<p>但是，这个项目实在太出众了，很多高手看到了并贡献了众多代码。比如现在Alvin自己提交了一个文件：</p>
<p><img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619152236145-1657045698.png"></p>
<p>现在原作者项目已经发生了改变，那Harry账号下的githubTest如何与原作者Alvin的项目保持同步呢？Harry需要做以下三步操作：</p>
<p> <img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619152247886-1553420485.png"></p>
<p><strong>1. fetch</strong></p>
<p>现在代码不同步了，我们要先把Alvin仓库的代码fetch到自己电脑的仓库下。注意，这是在自己电脑上操作，不是在GitHub上操作。</p>
<div class="cnblogs_code">
<pre>git fetch git@github.com:yychuyu/githubTest.git master:latest</pre>
</div>
<p>上面这条命令，git fetch 之后的那部分，是原作者Alvin项目git地址，通过点击原项目「clone or download」按钮可以看到。再之后master:latest这部分，master是原项目分支，latest是自己项目分支。</p>
<p>如果latest分支不存在的话，将自动创建。其实也可以将代码fetch到自己的master分支，但也不建议这么做。</p>
<p><strong>2. merge</strong></p>
<p>代码fetch到latest分支之后，再切到master分支，再使用git merge命令将最新代码合并到master分支。</p>
<p><strong>3. push</strong></p>
<p>现在，Harry电脑上的代码与原项目代码保持同步了。我们再使用git push命令，就可以将最新代码推到Harry账号下githubTest项目里。</p>
<p>以上的三个步骤具体操作过程如下图示：</p>
<p> <img src="https://img2018.cnblogs.com/blog/1429143/201906/1429143-20190619152341380-250882926.png"></p>
<p>接下来，Harry就可以在此基础上，继续贡献自己的代码了。</p>
<p> </p><br><br>
来源：https://www.cnblogs.com/klyjb/p/11051565.html
頁:
[1]