版本控制与协作 / 系统课时

理解冲突产生的原因

理解冲突产生的原因

学习目标

完成本课后,你将能够:

  • 说明 Git 无法自动合并的典型条件
  • 区分内容冲突与文件损坏
  • 使用状态命令定位未合并路径

问题背景或应用场景

冲突不是 Git 出错,而是自动合并缺少足够信息。两个分支从共同祖先出发,对同一文件相同区域做出不同修改时,Git 无法判断哪一版代表最终业务意图,只能暂停并交给开发者决定。

核心原理

三方合并会比较共同祖先、当前分支和传入分支。如果只有一方修改某行,Git 通常可以自动接受;若双方修改不同区域,也常能自动组合;双方对同一区域做出不兼容修改时才产生内容冲突。

冲突还可能包括一方删除、一方修改,双方重命名到不同位置等结构冲突。发生冲突后,仓库进入合并中间状态,未解决路径在索引中保留多个阶段版本。此时应先理解意图,再编辑文件,而不是机械删除标记。

Git 冲突产生原因图

基础用法

执行合并后使用 git status 查看未合并路径,使用 git diff --name-only --diff-filter=U 只列出冲突文件。想放弃整个合并时使用 git merge --abort。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。

bash
rm -rf git-conflict-cause-demo
mkdir git-conflict-cause-demo
cd git-conflict-cause-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "mode=base
" > config.txt
git add config.txt
git commit -q -m "chore: add base config"
git switch -q -c left
printf "mode=left
" > config.txt
git add config.txt
git commit -q -m "feat: left mode"
git switch -q main
git switch -q -c right
printf "mode=right
" > config.txt
git add config.txt
git commit -q -m "feat: right mode"
git switch -q left
if git merge right >/dev/null 2>&1; then
  echo "merge: success"
else
  echo "merge: conflict"
fi
printf "status: "
git status --short
git merge --abort

预期输出

text
merge: conflict
status: UU config.txt

Tips

  • 冲突前先找共同祖先和双方提交,理解为什么分叉。
  • 使用 git status 作为冲突处理入口。
  • 冲突越晚处理,上下文越难回忆,应频繁同步主分支。

常见错误

1. 把冲突当成文件损坏

  • 错误表现:直接删除文件重新创建。
  • 产生原因:没有理解三方合并和双方修改。
  • 正确处理:先查看当前、传入与祖先版本,再决定最终内容。
  • 修复结果:保留双方必要逻辑。

2. 冲突后继续执行普通提交

  • 错误表现:Git 提示仍有未合并文件。
  • 产生原因:索引中仍存在未解决阶段。
  • 正确处理:列出 diff-filter=U 文件并逐个解决、暂存。
  • 修复结果:所有未合并路径清零。

本课练习

1. 制造不同区域修改

  • 任务目标:验证自动合并。
  • 输入或初始条件:两个分支修改同一文件不同段落。
  • 实现要求:执行合并。
  • 验收条件:Git 自动合并且无冲突标记。

2. 制造删除与修改冲突

  • 任务目标:认识结构冲突。
  • 输入或初始条件:一方删除文件,另一方修改文件。
  • 实现要求:执行合并并检查状态。
  • 验收条件:能解释 modify/delete 状态。

3. 定位冲突文件

  • 任务目标:练习过滤命令。
  • 输入或初始条件:仓库包含多个正常修改和一个冲突。
  • 实现要求:只列出未合并路径。
  • 验收条件:输出仅包含冲突文件。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解冲突产生的原因

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通