github Pull Request合入全流程介绍

图解全流程

详细步骤

1. fork仓库

2. clone fork仓库到本地

3. 关联upstream原仓库

在fork本地仓库输入下面命令进行关联：

git remote add upstream <原仓库github地址>

查看仓库地址：

git remote -v

4. fork本地仓库commit+push

修改完文件后执行下面命令：

git add .
git commit -m 'message'
// push推送到fork远程仓库
git push origin master

5. 发起Pull Request

在fork远程仓库，点击Pull Request->New Pull Request，进入以下截图页面

base repository为原仓库的某个分支，

head repository为fork仓库发某个分支

head的某个分支代码合到base的某个分支

6. 原仓库合入PR

进入原仓库的Pull requests可看到刚才发起的PR

github pull request介绍：https://help.github.com/cn/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request

三种合入方式介绍：

• Merge pull request：将fork仓库的每一次提交都合并到原仓库，并且还产生了一个merge commit log。
• Squash and merge：将多个commit合并为一个commit添加到原仓库中，会产生一个新的commit id。
• Rebase and merge：将fork仓库的每一次提交都rebase到原仓库，但github的rebase行为与git rebase略有偏差。GitHub上的变基和合并始终会更新提交者信息并创建新的提交,也就是产生新的commit id。

选择“Squash and merge”进行合入



合入后会产生如下图的一条commit：

这条commit包含了发起PR时fork仓库的几个commit

7. fork本地仓库更新

原仓库合入后产生了一条新的commit id，为了保持一致，需要在fork本地仓库进行更新

// 更新并合并原仓库的master分支
git pull --rebase upstream master

更新前：test4和test5为两次commit



更新后：test4和test5合并为fork原仓库通过squash and merge产生的commit

8. 修改文件后，再commit + push

这时，push推送到远程仓库，需要进行强制覆盖fork远程仓库。因为fork远程仓库仍是test4、test5两次提交的commit，而本地仓库已经更新同步为原仓库的合并commit。不强制覆盖则会在push时提示需要更新与远程分支同步。

git push origin master --force

到这里！！！fork、clone、commit、push、pull整个流程已完成。

之前也写过类似的两篇文章：

1. github的pull Request使用
2. github上fork原项目，如何将本地仓库代码更新到最新版本？
   
   不同之处在于合入方式，之前写的是按照"merge pull request“合入，在最近开发中，发现这样始终会多出一个commit，在fork仓库同步的时候又会多出一个commit，来回多了两个commit，并且commit log看起来也会交错在一起，不便于阅读。。诸如下图
   
   

通过本篇文章操作后，commit log如下图，清晰整洁。

不断的学习！不断的爬坑！不断的总结！写出更优质的代码！