Git 合并冲突不可怕:Github-for-beginners 手把手教你读懂冲突标记并 5 步解决
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 需要你做一个"保留哪个版本"的决定。
读懂冲突标记: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 按钮,创建属于你自己的副本:
然后把你的副本克隆到本地:
git clone https://gitcode.com/gh_mirrors/gi/Github-for-beginners
第 2 步:用官方练习任务制造冲突
guides/merge-conflicts.md 里给出了一个标准的冲突复现练习:
- 从
main创建两个分支branch-a和branch-b - 在两个分支里修改 practice-file.md 的同一行
- 先把
branch-a合并进main,再合并branch-b - 此时冲突就会出现,按上文 5 步解决它
在 practice-file.md 中操作非常安全——这个文件本来就是给学员随便改的,怎么折腾都不影响他人。
第 3 步:把解决好的分支提出来
解决完冲突后,推送分支并通过 Pull Request 提交。在创建 PR 时,务必确认"compare"一侧选择的是你自己的分支:
创建成功后,打开 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。
记住:犯错是学习的一部分,大胆去合并吧! 🚀



