当我们想在 Github 上的某个开源仓库中贡献自己的代码时，通常会先 Fork 这个开源代码仓库，然后clone到本地，提交自己的修改，最后 Pull Request 进行合并。
由于开源仓库通常会有很多人一起贡献代码，要持续与这些项目贡献者保持协作，我们就会遇到一个很常见的问题：如何与源仓库保持同步？
参考以下步骤即可与 Fork 的源仓库保持同步。
配置远程仓库
先查看当前配置的远程仓库，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)
配置需要同步的上游仓库（即Fork的源仓库），ORIGINAL_OWNER为源仓库作者用户名，ORIGINAL_REPOSITORY为源仓库名。
$ git remote add upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git
验证配置，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分支
从上游仓库获取分支及其各自的提交。对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
切换本地默认分支，本例中即main分支。
$ git checkout main
> Switched to branch 'main'
将上游默认分支 - 本例中为 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
————————————————
版权声明：本文为CSDN博主「_9247_」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/m0_55236025/article/details/114108855