Github -- 同步一个上游的 Fork

Fork 一个上游的项目，然后将 Fork 的项目 clone 到本地，使劲写。有一天突然发现，诶，上游更新了～那么问题来了，要把上游的更新内容同步到本地来。

所以找到了 Fork a repo 和 Syncing a fork，在这里总结一下。

步骤如下

Fork 一个项目，只要在 github 上点击源项目的 fork 就行了，界面操作简单易懂。
项目 Fork 过来后，clone 到本地。
配置与源项目的同步：

切换到本地项目的目录，执行 git remote -v，输出如下内容：

   origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
   origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

把上游的仓库加进来：

   $ git remote add upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git

再执行一次 git remote -v，输出如下内容：

   origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
   origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)
   upstream	https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (fetch)
   upstream	https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

这样，就配置好了，但是这个时候还没有同步，只是进行了同步的配置。

进行同步。
获取上游分支：
```
   $ git fetch upstream
```

切换到 master 分支：

   $ git checkout master
   Switched to branch 'master'

合并上游的 master 分支到本地的 master 分支上：

   $ git merge upstream/master
   Updating 34e91da..16c56ad
   Fast-forward
   README.md                 |    5 +++--
   1 file changed, 3 insertions(+), 2 deletions(-)

合并后，使用命令 git status，可以看到如下信息：

   位于分支 master
   您的分支领先 'origin/master' 共 8 个提交。
     （使用 "git push" 来发布您的本地提交）
   无文件要提交，干净的工作区

用 git push 把从上游 merge 到本地的新代码 push 到自己的 master 分支上：

   Counting objects: 45, done.
   Delta compression using up to 4 threads.
   Compressing objects: 100% (30/30), done.
   Writing objects: 100% (31/31), 3.67 KiB | 0 bytes/s, done.
   Total 31 (delta 12), reused 0 (delta 0)
   To https://github.com/OUR_USERNAME/YOUR_FORK.git
      226e4dc..61a1fc6  master -> master

这次是真的大功告成了，现在，本地的 master 分支已经和上游保持一致。

补充

本地的 master 分支用于和上游保持一致。
其他分支可用来编写代码。

merge 之后，再次贡献代码时：

切换到写代码的分支，如：

 $ git checkout coffee
 Switched to branch 'coffee'

更新 coffee 分支：
```
 $ git rebase master
```

此补充参考了另一篇博客。

六年后的补充

几年没用 git 之后，我还可以再翻看这篇文章来进行操作，做笔记真是一件不错的事情。

我还顺便翻到了六年前尝试、想要、最终没做的事情：给 rally 的上游提交 pull request。那时我还画了个流程图，也放到这里保存吧。

流程如下，命令就是图里用到的命令，就不写下来了：

fork 代码到自己的 github 仓库；
把代码 clone 到本地，编写/修改代码；
提交代码；
将提交的代码 push 到自己所 fork 的仓库里；
在 github 上向上游提交 merge request；
如果上游合并了所提交的 merge request，那么需要在本地执行合并上游的操作，让本地和上游保持一致。

步骤如下

补充

六年后的补充

Share on: