Github Fork 之后与源仓库保持同步

当我们想在 Github 上的某个开源仓库中贡献自己的代码时，通常会先 Fork 这个开源代码仓库，然后clone到本地，提交自己的修改，最后 Pull Request 进行合并。

由于开源仓库通常会有很多人一起贡献代码，要持续与这些项目贡献者保持协作，我们就会遇到一个很常见的问题：如何与源仓库保持同步？

参考以下步骤即可与 Fork 的源仓库保持同步。

配置远程仓库

1. 先查看当前配置的远程仓库，YOUR_USERNAME为你的 Github 用户名，YOUR_FORK为 Fork 的仓库名。

   $ git remote -v
   > origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
   > origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)
   

2. 配置需要同步的上游仓库（即Fork的源仓库），ORIGINAL_OWNER为源仓库作者用户名，ORIGINAL_REPOSITORY为源仓库名。

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

3. 验证配置，upstream开头的即是远程仓库

   $ 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)
   

同步Fork分支

1. 从上游仓库获取分支及其各自的提交。对BRANCHNAME的提交将存储在本地分支upstream/BRANCHNAME中。

   $ git fetch upstream
   > remote: Counting objects: 75, done.
   > remote: Compressing objects: 100% (53/53), done.
   > remote: Total 62 (delta 27), reused 44 (delta 9)
   > Unpacking objects: 100% (62/62), done.
   > From https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY
   >  * [new branch]      main     -> upstream/main
   

2. 切换本地默认分支，本例中即main分支。

   $ git checkout main
   > Switched to branch 'main'
   

3. 将上游默认分支 - 本例中为 upstream/main - 的更改合并到本地默认分支。

   $ git merge upstream/main
   > Updating a422352..5fdff0f
   > Fast-forward
   >  README                    |    9 -------
   >  README.md                 |    7 ++++++
   >  2 files changed, 7 insertions(+), 9 deletions(-)
   >  delete mode 100644 README
   >  create mode 100644 README.md
   

   这个操作会使本地的默认分支与上游仓库同步，而不会丢失本地更改。

   如果你本地没有任何单独的提交，Git会直接进行"fast-forward"操作：

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

推送同步

上述步骤仅仅同步了仓库的本地副本。要在 GitHub 上同步更新，还需要将本地更改推送到 Github 在线仓库：

git push origin main

有时，推送本地副本到在线仓库会遇到如下错误：

$ git push origin main
To https://github.com/YOUR_USERNAME/YOUR_FORK.git
 ! [rejected]        main -> main (fetch first)
error: 推送一些引用到 'https://github.com/YOUR_USERNAME/YOUR_FORK.git' 失败
提示：更新被拒绝，因为远程仓库包含您本地尚不存在的提交。这通常是因为另外
提示：一个仓库已向该引用进行了推送。再次推送前，您可能需要先整合远程变更
提示：（如 'git pull ...'）。
提示：详见 'git push --help' 中的 'Note about fast-forwards' 小节。

这说明你的远程仓库有本地副本中不包含的提交，只需要执行如下操作即可：

$ git pull origin main