GitHub 仓库同步与冲突解决

473 字
2 分钟
GitHub 仓库同步与冲突解决
2026-03-09
浏览量 加载中...

在 Fork 了一个开源项目并进行大量个性化定制后,原作者的更新往往会带来大量的合并冲突。本文记录了在 VS Code 环境下,如何同步上游仓库并手动解决冲突的完整流程。

1. 环境准备:添加上游仓库#

首先,需要让本地仓库知道“原作者”的存在。我们将其定义为 upstream。

Terminal window
# 添加原作者仓库地址
git remote add upstream [https://github.com/原作者用户名/项目名.git](https://github.com/原作者用户名/项目名.git)
# 确认远程分支状态
git remote -v

2. 获取更新与触发合并#

在确保本地修改已全部 commit 的前提下,拉取作者的最新代码:

Terminal window
# 获取上游所有分支更新
git fetch upstream
# 合并上游主分支到本地当前分支
git merge upstream/master

3. 手动解决冲突 (Merge Conflicts)#

当终端提示 Automatic merge failed 时,VS Code 会进入冲突处理模式。

核心术语辨析#

在 VS Code 的冲突编辑器中,请务必认清:

  • Current Change (当前更改):是你自己在本地修改的代码。
  • Incoming Change (传入的更改):是原作者更新的代码。

操作流#

建议点击右下角的 “Open in Merge Editor”。左侧为作者更新,右侧为你的定制,下方为最终结果。

4. 完成合并与推送#

解决所有冲突后,执行以下步骤:

  1. 暂存修改:点击侧边栏 Merge Changes 列表文件旁的 + 号。
  2. 提交合并:点击消息框上方的 Continue。
  3. 同步云端:点击左下角的 Sync Changes(即 git push)。

注意: 同步时显示的数字(如 100 ↑)代表本地领先于 GitHub 服务器的提交数,包含了自己的改动和合并进来的作者记录。

5. 构建测试#

合并后务必运行构建脚本,确保项目正常

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

最后更新于 2026-03-09,距今已过 221 天

部分内容可能已过时

评论区

Profile Image of the Author
加菲魚
堆内存中的一个持久化对象。
分类
标签
站点统计
文章
23
分类
5
标签
16
总字数
27,576
访问量
...
访客数
...
运行时长
0 天
最后活动
0 天前

目录