github Pull Request合入全流程介绍
之前也写过类似的两篇文章:
- github的pull Request使用
- github上fork原项目,如何将本地仓库代码更新到最新版本?
不同之处在于合入方式,之前写的是按照"merge pull request“合入,在最近开发中,发现这样始终会多出一个commit,在fork仓库同步的时候又会多出一个commit,来回多了两个commit,并且commit log看起来也会交错在一起,不便于阅读。。诸如下图
通过本篇文章操作后,commit log如下图,清晰整洁。
------进入正题-------
图解全流程
详细步骤
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整个流程已完成。
不断的学习!不断的爬坑!不断的总结!写出更优质的代码!