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

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

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

问题描述

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


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

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

bash 复制代码
git remote add upstream <原项目仓库的URL>

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

bash 复制代码
git remote -v

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


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

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

bash 复制代码
git fetch upstream

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


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

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

bash 复制代码
git checkout main
git merge upstream/main

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


步骤四:解决合并冲突(如果有)

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

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

bash 复制代码
git add <冲突文件>

然后,完成合并操作:

bash 复制代码
git commit

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

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

bash 复制代码
git push origin main

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


总结

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

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

相关推荐
掘金安东尼17 分钟前
前端周刊第421期(2025年7月1日–7月6日)
前端·面试·github
小林up2 小时前
github push:ssh: connect to host github.com port 22
运维·ssh·github
Leinwin9 小时前
微软开源GitHub Copilot Chat,AI编程领域迎新突破
microsoft·github·copilot
草梅友仁12 小时前
草梅 Auth 与 AI 开发心得 | 2025 年第 27 周草梅周报
github·ai编程·视觉设计
qianmoQ16 小时前
GitHub 趋势日报 (2025年07月02日)
github
A5资源网20 小时前
cloudflare配合github搭建免费开源影视LibreTV一个独享视频网站 详细教程
github
mortimer20 小时前
从零到一:构建一个 Chatterbox-TTS API 服务
开源·github·ai编程
真智AI20 小时前
利用 Claude Opus 4 自动化 GitHub 工作流:从安装到实战详解
运维·自动化·github
寻月隐君1 天前
Rust 网络编程实战:用 Tokio 手写一个迷你 TCP 反向代理 (minginx)
后端·rust·github
喜欢吃豆1 天前
快速手搓一个MCP服务指南(九): FastMCP 服务器组合技术:构建模块化AI应用的终极方案
服务器·人工智能·python·深度学习·大模型·github·fastmcp