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

手动解决合并冲突

手动解决合并冲突

学习目标

完成本课后,你将能够:

  • 完成从识别到提交的冲突处理流程
  • 组合双方必要修改形成最终内容
  • 验证合并提交和工作区状态

问题背景或应用场景

读懂标记后,需要把业务决策落实为最终文件。解决冲突不是选择“左边或右边”这么简单,常常需要组合双方修改、调整接口并运行测试。只有暂存解决后的文件,Git 才认为该路径已处理。

核心原理

标准流程是:确认冲突文件,理解双方提交,编辑最终内容,运行语法与测试检查,执行 git add 标记已解决,最后创建合并提交。git add 在这里不是简单“加入新文件”,而是告诉索引不再保留多阶段冲突状态。

若处理方向错误,可以在提交前使用 git merge --abort 回到合并前。合并完成后仍应检查提交的两个父提交和最终差异,确保没有误删无冲突文件。

基础用法

使用 git status 跟踪进度。每解决一个文件就暂存一个文件;全部完成后确认不存在 unmerged paths,再执行提交。提交说明应说明合并目的,必要时记录关键冲突决策。

完整可运行示例

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

bash
rm -rf git-resolve-merge-demo
mkdir git-resolve-merge-demo
cd git-resolve-merge-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "env=base
" > app.conf
git add app.conf
git commit -q -m "chore: add base config"
git switch -q -c feature
printf "env=base
feature=true
" > app.conf
git add app.conf
git commit -q -m "feat: enable feature"
git switch -q main
printf "env=production
" > app.conf
git add app.conf
git commit -q -m "chore: set production env"
if git merge feature >/dev/null 2>&1; then :; fi
printf "env=production
feature=true
" > app.conf
git add app.conf
git commit -q -m "merge: combine environment settings"
printf "file:
"
cat app.conf
printf "latest: "
git log -1 --format=%s
printf "parents: "
git show -s --format='%P' HEAD | awk '{print NF}'

预期输出

text
file:
env=production
feature=true
latest: merge: combine environment settings
parents: 2

Tips

  • 解决后运行项目测试,而不只检查标记消失。
  • 一次处理一个文件并持续查看状态。
  • 重要冲突决策写入提交说明或评审记录。

常见错误

1. 编辑后忘记 git add

  • 错误表现:提交仍提示未解决冲突。
  • 产生原因:工作区已改,但索引仍保存多阶段状态。
  • 正确处理:对已解决文件执行 git add。
  • 修复结果:状态不再显示 unmerged。

2. 只选一侧导致功能丢失

  • 错误表现:合并成功但缺少另一分支必要逻辑。
  • 产生原因:把冲突处理误解为二选一。
  • 正确处理:根据业务组合两侧内容并测试。
  • 修复结果:双方目标在最终文件中同时满足。

本课练习

1. 组合两侧配置

  • 任务目标:练习非二选一解决。
  • 输入或初始条件:一侧修改环境,一侧新增开关。
  • 实现要求:形成同时包含两项的最终文件。
  • 验收条件:测试通过且无标记。

2. 中止错误合并

  • 任务目标:练习恢复。
  • 输入或初始条件:开始处理后发现目标分支选错。
  • 实现要求:执行 abort。
  • 验收条件:HEAD、索引和工作区恢复合并前。

3. 检查合并父提交

  • 任务目标:理解合并对象。
  • 输入或初始条件:完成一次非快进合并。
  • 实现要求:查看父提交数量。
  • 验收条件:合并提交有两个父对象。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

手动解决合并冲突

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

登录哪都通