如何在 GitHub Fork 项目中同步上游更新，同时保持本地修改

在github上，fork别人的项目，如何保持同步，还不覆盖自己的修改？

当我们在 GitHub 上 fork 了一个开源项目并对其进行了自定义修改时，如何在不覆盖自己修改的情况下保持 fork 与原始项目的同步，是一个常见的问题。本文将详细介绍这个过程，并提供一些注意事项，帮助我们更好地管理 fork 项目。

1. 背景介绍

在 GitHub 上 fork 项目通常是为了便于在已有项目的基础上添加自己的修改、修复 Bug 或实现新功能。但原始项目通常会不断更新，尤其是活跃的开源项目。这时就需要定期同步 fork 仓库，以便利用最新的改进和修复。同步过程中要注意的是，如何避免同步更新时覆盖掉自己的修改。

2. 基本概念

在开始之前，了解几个关键概念会有助于更顺利地完成操作：

•Fork：在 GitHub 上 fork 的项目是原始项目的完整副本。fork 后，我们可以随意对 fork 项目进行修改，和原始项目完全独立。

•上游仓库（upstream repository）：原始项目的仓库，即我们 fork 时的源仓库。在同步过程中，我们会通过添加 upstream 远程仓库指向原始项目。

•本地仓库：指的是我们在本地机器上克隆的 fork 仓库副本，是所有修改和操作的基础。

3. 操作步骤

接下来，我们将详细介绍如何将上游仓库的更新合并到自己的 fork 仓库中，确保同步的同时保留自己的修改。

第一步：配置上游仓库

1.首先在本地克隆自己的 fork 仓库：

git clone https://github.com/your-username/your-forked-repo.git
cd your-forked-repo

2.添加上游仓库的远程地址。这样可以确保每次操作都可以直接拉取原始项目的更新：

git remote add upstream https://github.com/original-owner/original-repo.git

3.我们可以使用 git remote -v 命令查看所有远程仓库地址，确认 upstream 是否添加成功：

git remote -v

第二步：获取上游仓库的更新

配置完成后，我们可以从上游仓库中获取最新的更新：

git fetch upstream

此命令会从 upstream 拉取所有的更新，但不会直接将更新合并到当前分支，而是将其保存在本地的 upstream 远程分支中。

第三步：合并更新到本地分支

在获取更新后，接下来需要将上游更新合并到我们自己的分支。假设我们在 main 分支上操作，可以执行以下命令

git checkout main
git merge upstream/main

在此步骤中可能会遇到一些 代码冲突，这是因为我们的本地修改和上游更改可能在同一文件上有不同内容。Git 会标记出冲突部分，通常在代码文件中以 <<<<<<< HEAD 和 ======= 这样的分隔符标记。

可以手动编辑文件解决冲突，确认无误后再继续提交合并。

第四步：推送到 GitHub

合并上游仓库的更新并解决冲突后，再将最新的 main 分支推送到 GitHub fork 仓库中：

git push origin main

这样，我们的 fork 仓库就与上游仓库保持同步了，同时保留了我们自己的修改内容。

4. 高级技巧：分支管理和 cherry-pick

如果希望将自己的修改独立于主分支，可以创建一个新的分支来管理自己的更改。这样，在主分支上同步上游更新后，可以在自定义分支中选择性地应用更新，保持自己的修改独立且不被覆盖。

创建独立分支管理修改

1.从主分支创建一个新的分支保存修改：

git checkout -b my-feature-branch

2.在新的分支中进行开发、提交我们的更改。

3.当主分支同步上游仓库的更新后，可以使用 git cherry-pick 命令将特定的提交选择性地应用到我们的自定义分支，确保在不覆盖自己修改的情况下同步上游更新。

cherry-pick 示例

假设希望将 main 分支中某个特定的提交应用到自定义分支：

git checkout my-feature-branch
git cherry-pick <commit-hash>

这样可以有选择性地引入更新，避免影响自定义分支的稳定性。

5. 注意事项

•避免直接在主分支上修改代码：主分支建议专门用于同步上游更新，不要在主分支上做开发工作，减少同步时冲突的可能。

•注意频率：同步的频率可以根据上游项目的更新情况来决定。对于活跃的项目，可以定期同步（如每周一次）；对于不常更新的项目，不必频繁操作。

•及时处理冲突：遇到冲突时尽量及时处理并测试，确保合并后的代码可以正常运行。

•保持备份：在执行重要同步操作前，可以使用 git branch <backup-branch-name> 创建一个备份分支，方便在出现问题时进行恢复。

6. 总结

通过以上步骤和技巧，我们可以有效地同步 GitHub fork 仓库与上游项目的更新，同时保留自己对项目的个性化修改。定期同步 fork 仓库可以让随时掌握项目的最新进展，利用原始项目的新功能和优化。

通过合理的分支管理策略、cherry-pick 操作以及对冲突的处理，可以确保在 Git 项目协作中更加灵活、有效地管理自己的代码修改。