版本控制与协作 / 系统课时
理解冲突产生的原因
理解冲突产生的原因
学习目标
完成本课后,你将能够:
- 说明 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.txtTips
- 冲突前先找共同祖先和双方提交,理解为什么分叉。
- 使用
git status作为冲突处理入口。 - 冲突越晚处理,上下文越难回忆,应频繁同步主分支。
常见错误
1. 把冲突当成文件损坏
- 错误表现:直接删除文件重新创建。
- 产生原因:没有理解三方合并和双方修改。
- 正确处理:先查看当前、传入与祖先版本,再决定最终内容。
- 修复结果:保留双方必要逻辑。
2. 冲突后继续执行普通提交
- 错误表现:Git 提示仍有未合并文件。
- 产生原因:索引中仍存在未解决阶段。
- 正确处理:列出
diff-filter=U文件并逐个解决、暂存。 - 修复结果:所有未合并路径清零。
本课练习
1. 制造不同区域修改
- 任务目标:验证自动合并。
- 输入或初始条件:两个分支修改同一文件不同段落。
- 实现要求:执行合并。
- 验收条件:Git 自动合并且无冲突标记。
2. 制造删除与修改冲突
- 任务目标:认识结构冲突。
- 输入或初始条件:一方删除文件,另一方修改文件。
- 实现要求:执行合并并检查状态。
- 验收条件:能解释 modify/delete 状态。
3. 定位冲突文件
- 任务目标:练习过滤命令。
- 输入或初始条件:仓库包含多个正常修改和一个冲突。
- 实现要求:只列出未合并路径。
- 验收条件:输出仅包含冲突文件。
按自己的节奏,确认真正理解。