解决合并冲突(Resolving Merge Conflicts)是一个用于处理进行中 Git merge 或 rebase 冲突的技能。它强调按分支意图系统化解决冲突,并在整合后用自动化测试门禁验证完整性。
用途 当工作区出现合并冲突、文件中出现 CONFLICT 标记,或 rebase 因冲突中断时,使用该技能处理。目标是理解两个分支各自的语义意图,并综合出同时满足双方功能需求的解决方案。
核心原则
- 三方意图还原:在修改冲突代码前,先理解共同合并基(merge-base)祖先、传入改动(THEIRS)和目标分支改动(OURS)。
- 不盲目选择 ours 或 theirs:逐个检查每个冲突块,综合出保留双方功能需求的方案。
- 无残留冲突标记:在暂存前确认所有 <<<<<<<、=======、>>>>>>> 标记已完全清除。
- 非破坏性解决:保留相邻未改动的代码、注释和文档字符串,避免误删冲突块之外的行。
- 解决后必须测试通过:在结束合并(git commit)或 rebase(git rebase --continue)前,执行完整构建、类型检查和测试套件。
使用方式(分步流程)
- 识别冲突文件与合并上下文:运行 git status 列出所有冲突文件,并用 git log --oneline 查看 HEAD 与 MERGE_HEAD(或 REBASE_HEAD)最近的提交日志,判断各分支试图交付的功能或修复。对应验证命令为 git status --porcelain。
- 按语义解决冲突块:打开每个冲突文件,分析 HEAD(Ours)与传入(Theirs)之间的差异块,重写该块以满足双方需求。若双方都新增了导入、依赖或路由,应干净合并、避免重复。检查清单:冲突标记已移除、重复的导入导出已去重、双方新功能均保留。
- 用构建与测试套件验证:在解决后的工作树上运行仓库的类型检查器、linter 和测试套件。若测试失败,排查是否因解决冲突破坏了运行时假设。
- 暂存并结束合并或 rebase:git add <files> 暂存解决后的文件;合并用 git commit(保留标准合并提交信息),rebase 用 git rebase --continue。最后用 git status 确认工作树干净。
审查基线信息
- 祖先检查:git show :1:<file>(Base)、:2:<file>(Ours)、:3:<file>(Theirs)。
- 集成门禁:运行项目构建或测试命令。
禁止的做法
- 为求快速用 git checkout --ours 或 --theirs 整体接受一方:在语义冲突中禁止,整体检出会覆盖有效工作并回退另一分支的关键修复。
- 删除失败的测试以让合并提交通过:应修改代码使测试通过;删除测试会降低覆盖率并引入回归。
- 不运行完整测试套件就假定代码没问题:提交合并前必须测试通过,手工解决冲突常引入语法错误和断裂的导入。
适用场景 适用于出现合并冲突标记、rebase 冲突中断、需要判断双方改动意图并整合的场景。
限制 该技能以 Git 命令和项目自身的构建、类型检查、测试套件为前提;具体构建与测试命令依赖仓库配置,资料未提供通用命令。