Git 合并冲突不可怕:Github-for-beginners 手把手教你读懂冲突标记并 5 步解决

原创2026-11-16 11:46:3881 阅读

Git 合并冲突不可怕:Github-for-beginners 手把手教你读懂冲突标记并 5 步解决

遇到 Git 合并冲突(Merge Conflict)先别慌。本文带你用免费的练习仓库 Github-for-beginners,读懂 <<<<<<<、=======、>>>>>>> 冲突标记,并用 5 个步骤彻底解决合并冲突,是面向新手的完整 Git 合并冲突教程。

对刚接触 Git 的朋友来说,CONFLICT (content): Merge conflict in README.md 这样的红色报错往往意味着"游戏结束"。其实合并冲突只是 Git 在告诉你:两个分支改了同一行,我不知道听谁的,请你来拍板。看懂冲突标记后,它反而是最直观、最安全的合并方式。

什么是 Git 合并冲突?

合并冲突发生在 Git 尝试把两个分支合在一起时:如果同一个文件的同一行在两个分支里被改成了不同的内容,Git 就无法自动决定保留哪个版本,于是暂停合并,把决定权交给你。

常见的触发场景有:

  • 把功能分支合并回 main 时
  • 拉取远程更新时本地也有修改
  • 多人协作中两个人编辑了同一行

下面的 Git 工作流图展示了代码从本地分支推送到远程的完整过程——冲突通常就发生在两个分支"汇合"的那一刻:

Git 工作流示意图:从工作区、暂存区到本地提交再推送到远程仓库

💡 记住一个核心结论:冲突不是错误,而是 Git 需要你做一个"保留哪个版本"的决定。

读懂冲突标记:3 行符号完整解读

打开有冲突的文件,你会看到 Git 自动插入的冲突标记。它们是理解一切的基础:

<<<<<<< HEAD
Hello, I am Alice.
=======
Hello, I am Bob.
>>>>>>> feature/bob-intro

三组标记的含义如下:

标记 含义
<<<<<<< HEAD 当前分支(你正站立的分支)的修改开始
======= 分隔线,上方是"我的",下方是"对方的"
>>>>>>> 分支名 被合并进来的分支的修改结束

换句话说,冲突块就像一道选择题:上面是"我的答案",下面是"别人的答案"。你要做的只是删掉不想要的版本,并移除全部 3 行标记。

⚠️ 最常见的翻车点:只删了文字却忘了删冲突标记,导致 <<<<<<< 被提交进仓库。保存前请全文搜索确认。

最快 5 步解决 Git 合并冲突

以下 5 步适用于任何规模的冲突,也是 guides/merge-conflicts.md 中官方指南的完整流程:

第 1 步:用 git status 找到冲突文件

git status

Git 会用 both modified 标出发生冲突的文件,这是你的"任务清单"。

第 2 步:打开文件,定位冲突块

用 VS Code 打开冲突文件,每处冲突都会高亮显示。VS Code 还会在冲突上方提供快捷按钮:

  • Accept Current Change —— 保留当前分支的版本
  • Accept Incoming Change —— 保留被合并分支的版本
  • Accept Both Changes —— 两个都保留
  • Compare Changes —— 并排对比两个版本

第 3 步:编辑文件,只留下你要的内容

三种典型选择:

  • 保留我的版本:删掉 ======= 到 >>>>>>> 之间的内容和 <<<<<<< HEAD 行
  • 保留对方的版本:删掉 <<<<<<< HEAD 到 ======= 之间的内容和 >>>>>>> 行
  • 两个都保留:手动把两段内容合并成一段,然后删掉所有标记

第 4 步:把解决后的文件加入暂存区

git add README.md

这一步告诉 Git:"这个文件的冲突我已经处理好了。"

第 5 步:提交,完成合并

git commit -m "Resolve merge conflict in README.md"

提交完成后,合并就正式闭环了。🎉

后悔药:git merge --abort

如果你打开文件后觉得"这冲突太复杂,我不想处理了",一条命令就能回到冲突前的状态:

git merge --abort

它会取消整个合并操作,把分支恢复原样。这就像浏览器里的"撤销",让新手可以放心大胆地尝试——反正随时可以重来。

在 Github-for-beginners 里动手实战

光看不动手,冲突解决学不会。Github-for-beginners 是专为新手设计的 GitHub 工作流练习仓库,内置了 fork、克隆、分支、提交、推送和 Pull Request 全套练习。

第 1 步:Fork 并克隆仓库

点击仓库页面上方的 Fork 按钮,创建属于你自己的副本:

Github-for-beginners 仓库首页,红圈标注右上角的 Fork 按钮

然后把你的副本克隆到本地:

git clone https://gitcode.com/gh_mirrors/gi/Github-for-beginners

第 2 步:用官方练习任务制造冲突

guides/merge-conflicts.md 里给出了一个标准的冲突复现练习:

  1. 从 main 创建两个分支 branch-a 和 branch-b
  2. 在两个分支里修改 practice-file.md 的同一行
  3. 先把 branch-a 合并进 main,再合并 branch-b
  4. 此时冲突就会出现,按上文 5 步解决它

在 practice-file.md 中操作非常安全——这个文件本来就是给学员随便改的,怎么折腾都不影响他人。

第 3 步:把解决好的分支提出来

解决完冲突后,推送分支并通过 Pull Request 提交。在创建 PR 时,务必确认"compare"一侧选择的是你自己的分支:

GitHub 创建 Pull Request 页面,红圈标注 compare 分支选择框与 Create pull request 按钮

创建成功后,打开 PR 页面,把地址复制下来用于提交作业记录:

GitHub Pull Request 详情页,红圈标注浏览器地址栏的 PR 链接

5 个习惯,从源头减少合并冲突

解决冲突靠技术,减少冲突靠习惯。guides/merge-conflicts.md 总结了 5 条最佳实践:

习惯 为什么有效
经常从 main 拉取最新代码 保持分支不过时
各自负责不同的文件/章节 避免改动重叠
和队友提前沟通 避免两人改同一行
小步提交、一次只做一件事 便于追踪和合并
分支生命周期尽量短 减少与 main 的漂移

一句话总结:冲突多,是因为分支"养"得太久。

总结与延伸阅读

  • Git 合并冲突 = 两个分支改了同一行,Git 请你拍板
  • 冲突标记 <<<<<<< / ======= / >>>>>>> 是"我的版本"与"对方版本"的分界
  • 解决流程固定 5 步:git status → 打开文件 → 编辑保留内容 → git add → git commit
  • 处理不了就 git merge --abort 一键回滚
  • 在 Github-for-beginners 里动手练 3 次,你就再也不会怕冲突了

想系统学习更多 GitHub 技能,可以继续阅读 guides/README.md 中的系列指南,常用命令速查表见 git-commands-reference.md。

记住:犯错是学习的一部分,大胆去合并吧! 🚀

登录后查看全文
Github-for-beginners