Github 的 Pull Request 教程

·  阅读 11799

Github 的 Pull Request 教程

什么是Pull Request

在知乎有一个高赞回答用一个类比的方式解释了什么是PR,这里我就先引述一下,不再重新解释了。

想想我们中学考试,老师改卷的场景吧。你做的试卷就像仓库,你的试卷肯定会有很多错误,就相当于程序里的 bug。老师把你的试卷拿过来,相当于先 fork。在你的卷子上做一些修改批注,相当于 git commit。最后把改好的试卷给你,相当于发 pull request,你拿到试卷重新改正错误,相当于 merge。

PR五步走

正如这个类比中提到的那样,在GitHub如果想要提交一个PR,大致分为一些几步:

  1. 先fork别人的项目到自己的仓库中去
  2. clone到本地进行修改,由于是自己的仓库,所以想怎么改都行
  3. 再修改完bug后,push回自己的仓库
  4. 如果你觉得自己的修改很完备,那么你就可以Pull Request,相当于请作者看一下自己的修改。
  5. 最后如果作者也认同这个修改,那么他会Merge到master上,而你也就成了这个项目的contributor。

光说不练假把式,相信点开这个教程的大部分人肯定现在正面对着如何提交PR,那么就和我一起来练练手吧!这里我使用GitHub上很火的一个数据分析教程来做个演示。

第一步:fork项目到自己的仓库中

在项目名称右边有fork键,登陆后点击即可fork仓库
在项目名称右边有fork键,登陆后点击即可fork仓库。
在这里插入图片描述
fork过程中可以看到这么一个图片,完成后将会跳转到你自己的项目分支。 第二步:打开Git Bash或者命令行,将项目下载到本地

$ git clone https://github.com/taotianli/Virgilio.git
Cloning into 'Virgilio'...
remote: Enumerating objects: 61, done.
remote: Counting objects: 100% (61/61), done.
remote: Compressing objects: 100% (52/52), done.
remote: Total 1784 (delta 27), reused 34 (delta 9), pack-reused 1723
Receiving objects: 100% (1784/1784), 7.15 MiB | 123.00 KiB/s, done.
Resolving deltas: 100% (824/824), done.
复制代码

你需要将git clone后的网址换成你自己的仓库,在看到done之后就代表这个仓库已经下载到了本地。 第三步:进入本地文件,并进行相应修改,这里以修改README.md作为演示。

$ cd Virgilio/
git add README.md
git commit -m 'Modefied the README.'
复制代码

第四步:上传到自己的GitHub仓库,并申请Pull Request 上传代码使用git push origin master命令就可以了,在之后就可以申请PR了。

在这里插入图片描述

回到主项目分支上,同时点击Pull Request -> New Pull Request,最后如果原作者觉得这个修改可以被加到项目中去,那么他就会同意合并,最后图下图所示。 注意:在作者合并之前,你可以做多次修改,在申请PR后只要push回自己的仓库,GitHub会自动记录修改并同步。

在这里插入图片描述

最后让我们在重复一下步骤,fork->clone->add&push->PR->merged,你学会了吗?

分类:
开发工具
标签:
分类:
开发工具
标签:
收藏成功!
已添加到「」, 点击更改