开发流程概述#
Pull Request 的一生#
假设你已经 fork
并 clone
了 <your-username>/MegEngine
的代码:
# 将 MegEngine 官方存储库添加为上游分支
git remote add upstream git@github.com:MegEngine/Documentation.git
git remote -v
# 基于上游的 master 分支,创建并切换到一个新分支用于开发
git fetch upstream
git checkout -b <branch-name> upstream/master
# 做一些相应的代码修改
# ....
# 做一些相应的本地测试
# 将修改过的代码提交记录到本地,并推送到默认的远端分支
git add <filenames>
git commit -m '<message>'
git push origin <branch-name>
# 跑到 https://github.com/<your-username>/MegEngine
# 根据相应的提示创建一个 Pull Request 并留下说明
# 开发者将 Review 你的代码并给出相应的答复
# 如果无需新的改动,则会被合入上游 master 分支
# 删除本地分支和远端分支
git branch -D <branch-name>
git push origin -d <branch-name>
如果你在发起 Pull Request 后有新增的改动,如果 Commits 记录很混乱,
为了保持历史记录的整洁,请使用 squash
或者 rebase
进行整理。
Note
一些开源项目要求避免使用 squash
和 rebase
以保证历史记录的完整性,在 MegEngine 中提倡使用这些操作,
目的是防止出现过多的 fix
性质的提交历史,请勿滥用。
保持和上游同步#
如果上游 master
分支有更新,为了避免存在冲突导致无法合并,
请同时更新你的本地 master
分支:
git checkout master
git pull upstream master # pull = fetch + merge
接下来需要用 rebase
命令更新你所开发的分支:
git checkout <branch-name>
git rebase master
git push origin --force <branch-name>
这个过程中可能需要解决一些冲突。
Note
如果你已经用 git push origin <branch-name>
将开发分支推送到远端,
则在进行 rebase
后再次 push
时需要添加 --force
参数。
仅修改最后的提交#
有些时候你只需要小修小补最后一次的提交,但不希望多出一次提交记录,可以使用:
git add <filenames>
git commit --amend
git push origin --force <brach-name>