如何在 Fork 的 GitHub 项目中保留自己的修改并同步上游更新？github_fork_update

如何在 Fork 的 GitHub 项目中保留自己的修改并同步上游更新？

在 GitHub 上 Fork 了一个项目后，你可能会对项目进行一些修改，同时原作者也在不断更新。如果想要在保留自己修改的基础上，同步原作者的最新更新，很多人会不知所措。本文将详细讲解如何在不丢失自己改动的情况下，将上游仓库的更新合并到自己的仓库中。

问题描述

假设你在 GitHub 上 Fork 了一个项目，并基于该项目做了一些修改，随后你发现原作者对项目进行了更新。此时你希望能够将这些更新同步到自己的项目中，同时保留你所做的修改。这个过程包括以下几个步骤。

---

步骤一：添加上游仓库为远程仓库

在你 Fork 的项目中，你需要将原作者的项目添加为远程仓库。这个远程仓库通常被称为 “upstream”（上游仓库）。首先，进入你本地仓库所在的目录，然后执行以下命令：

git remote add upstream <原项目仓库的URL>

通过此命令，Git 会将原项目作为一个新的远程仓库记录下来。你可以通过以下命令验证上游仓库是否添加成功：

git remote -v

这会列出你当前的所有远程仓库，确保其中包含 upstream。

---

步骤二：拉取上游仓库的最新更新

接下来，你需要从上游仓库获取最新的更改。执行以下命令：

git fetch upstream

这会将上游仓库的最新更新拉取到本地，但不会自动合并。

---

步骤三：将上游仓库的更新合并到本地分支

假设你在 main 分支上进行开发，你可以通过以下命令将上游仓库的更新合并到本地 main 分支：

git checkout main
git merge upstream/main

如果有新的提交，这一步会将上游项目的更改与本地项目进行合并。如果两者有冲突，Git 会提示你处理冲突。

---

步骤四：解决合并冲突（如果有）

在合并过程中，可能会出现冲突，这意味着上游的修改与本地的修改存在不兼容之处。Git 会在冲突的文件中标记出冲突内容，你需要手动编辑这些文件，选择保留哪部分内容或者进行合并。

当你解决了冲突后，使用以下命令标记冲突文件已解决：

git add <冲突文件>

然后，完成合并操作：

git commit

---

步骤五：将更新推送到你的远程仓库

最后，你需要将本地的更新推送到 GitHub 上你自己的仓库中：

git push origin main

这一步将把你本地的修改和合并结果同步到你 Fork 的 GitHub 仓库。

---

总结

1. 添加上游仓库：通过 git remote add upstream <原项目URL> 添加上游仓库。
2. 拉取上游更新：使用 git fetch upstream 拉取上游仓库的最新更改。
3. 合并上游更新到本地分支：通过 git merge upstream/main 将上游的更新合并到你的分支。
4. 解决冲突：如果有冲突，编辑文件并解决，使用 git add 和 git commit 继续合并。
5. 推送到远程仓库：通过 git push origin main 推送更新到 GitHub。

通过这些步骤，你可以在保留自己的修改的同时，获取原作者的最新更新，并保持你 Fork 的项目与原项目同步。