如何在 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 的项目与原项目同步。

相关推荐
小弥儿7 小时前
GitHub今日热榜 | 2026-07-19
人工智能·学习·github·知识图谱
dong_junshuai9 小时前
每天一个开源项目#43 KTransformers:18.5K星的异构MoE推理引擎
github
OpenTiny社区13 小时前
TinyRobot v0.5.0 新版本强在哪?
前端·vue.js·github
humbinal15 小时前
同时支持 gui & cli 的 parquet 文件查看工具,高性能小清新!
hive·python·rust·spark·开源·github·parquet
华科大胡子15 小时前
GitHub Actions 自动化运维实战:从入门到精通
github
fliter18 小时前
不用再反复 stash:用 Git Worktree 同时开发多个分支
后端·github
Tenifs18 小时前
在 VS Code 中,你可以通过修改全局或项目目录下的 settings.json 文件来彻底关闭 GitHub Copilot
github·copilot
Cosolar19 小时前
深入理解 AI Agent:设计原理与工程实践
人工智能·面试·github
love530love2 天前
ComfyUI 插件发布 GitHub Release + Comfy Registry (官方节点商店)完整复盘教程(从零开始)
人工智能·windows·github·devops
CoderJia程序员甲2 天前
GitHub 热榜项目 - 周榜(2026-07-18)
ai·大模型·llm·github·ai教程