SuperAPI AI 工具集

resolving-merge-conflicts

编程与开发

查看项目

更新于 10-24 16:17

技能介绍

解决合并冲突(Resolving Merge Conflicts)是一个用于处理进行中 Git merge 或 rebase 冲突的技能。它强调按分支意图系统化解决冲突,并在整合后用自动化测试门禁验证完整性。

用途 当工作区出现合并冲突、文件中出现 CONFLICT 标记,或 rebase 因冲突中断时,使用该技能处理。目标是理解两个分支各自的语义意图,并综合出同时满足双方功能需求的解决方案。

核心原则

  • 三方意图还原:在修改冲突代码前,先理解共同合并基(merge-base)祖先、传入改动(THEIRS)和目标分支改动(OURS)。
  • 不盲目选择 ours 或 theirs:逐个检查每个冲突块,综合出保留双方功能需求的方案。
  • 无残留冲突标记:在暂存前确认所有 <<<<<<<、=======、>>>>>>> 标记已完全清除。
  • 非破坏性解决:保留相邻未改动的代码、注释和文档字符串,避免误删冲突块之外的行。
  • 解决后必须测试通过:在结束合并(git commit)或 rebase(git rebase --continue)前,执行完整构建、类型检查和测试套件。

使用方式(分步流程)

  1. 识别冲突文件与合并上下文:运行 git status 列出所有冲突文件,并用 git log --oneline 查看 HEAD 与 MERGE_HEAD(或 REBASE_HEAD)最近的提交日志,判断各分支试图交付的功能或修复。对应验证命令为 git status --porcelain。
  2. 按语义解决冲突块:打开每个冲突文件,分析 HEAD(Ours)与传入(Theirs)之间的差异块,重写该块以满足双方需求。若双方都新增了导入、依赖或路由,应干净合并、避免重复。检查清单:冲突标记已移除、重复的导入导出已去重、双方新功能均保留。
  3. 用构建与测试套件验证:在解决后的工作树上运行仓库的类型检查器、linter 和测试套件。若测试失败,排查是否因解决冲突破坏了运行时假设。
  4. 暂存并结束合并或 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 命令和项目自身的构建、类型检查、测试套件为前提;具体构建与测试命令依赖仓库配置,资料未提供通用命令。