怎么使用 Git 和 Github 向开源项目提交 Pull Request

渣渣橘又跟我提了一下毒鸡汤,看了一下之前学的 python 脚本还能用,然后在 Github 上看到了一个爬虫集合的项目,收集各种爬虫

Github 的一大特色就是 Pull Request 功能(简写为 PR),之前没给他人的项目提交过 PR,来试一下做一个记录

Pull Request 是什么

Pull Request 是一种通知机制。你修改了他人的代码,将你的修改通知原来的作者,希望他合并你的修改,这就是 Pull Request

Pull Request 本质上是一种软件的合作方式,是将涉及不同功能的代码,纳入主干的一种流程。这个过程中,还可以进行讨论、审核和修改代码

简单的说是在自己本地仓库修改代码,提交到自己远程仓库,提交 PR 后被接受后,再会被合并到 master

具体流程

申请账号、添加 ssh 公钥等过程就不说了哈

1、fork

将项目 fork 到自己的仓库中,我以 awesome-spider 为例

进入到 awesome-spider 的 Github 项目中,点击右上角的 fork,稍等片刻,此项目便会出现在自己的仓库中

进到自己 fork 的项目中,就能看到Clone or download按钮,复制一下 SSH 链接或者 HTTPS 链接

通过上面的步骤,已经将远程仓库建好了

2、clone

将你刚才 fork 过来的项目 clone 到本地,用的是你刚才复制的 SSH 链接或者 HTTPS 链接

git clone git@github.com:sy-records/awesome-spider.git

进到 awesome-spider 目录中,试试跑一下git status,会提示现在是 master 分支

git remote -v命令,可以看到此时只与自己的远程仓库建立了连接

还需要与上游建立连接,这里上游指的是一开始 fork 的那个项目源,以 awesome-spider 为例,执行如下命令:

git remote add upstream git@github.com:facert/awesome-spider.git

再用git remote -v可以看到

与上游项目建立连接
与上游项目建立连接

接下来就能创建分支了

3、创建分支

继续运行命令:

git checkout -b dev

这个命令的意思是创建一个叫 dev 的分支,运行这个命令后 bash 将自动切换到新的分支下

4、修改代码

自行修改代码,完成开发等等

5、推送远程

提交的话也是按照正常流程提交就行了,push 之后,在自己的远程仓库便能看刚才 push 上去的分支了

5、提交 PR

找到 New pull request,需要注意的是 compare 处选择刚才提交上来的分支

提交 PR
提交 PR

然后点 Create pull request

写好名字,写好说明,提交,就 OK 啦

PR 创建后,就等着管理者是否接受该 PR 了

2 条评论

发表评论

*