如何通过GitHub API判断Git合并提交是否为干净合并？

我们正在为企业自动化GitHub流程，基于公开GitHub API构建工具，需要判断某合并提交是干净合并还是存在已解决的冲突。从GitHub的UI界面能看到它具备判断干净合并的机制（对应截图如下），下面是具体的实现思路：

• 调用提交详情API分析元数据
  调用GET /repos/{owner}/{repo}/commits/{commit_sha}接口，返回结果的commit对象里：

  • 干净合并的提交信息通常是标准格式，比如Merge branch 'feature/xxx' into 'main'，不会包含冲突文件的手动修改说明；
  • 干净合并的提交固定有2个父提交，而解决冲突后的合并提交虽然也有2个父提交，但提交信息里可能会附带冲突解决的备注（比如手动修改了哪些文件的冲突）。

• 分析合并提交的Diff内容
  调用GET /repos/{owner}/{repo}/commits/{commit_sha}/diff接口获取合并提交的差异内容：

  • 干净合并的Diff只会包含两个分支正常合并带来的代码变更，不会出现冲突解决过程中遗留的手动修改痕迹；
  • 如果是解决冲突后完成的合并，Diff里会显示冲突区域的手动调整内容，比如原本冲突的代码段被修改为最终版本，对比两个父提交的差异就能看出这是人为解决冲突后的结果。

• 结合Pull Request接口辅助判断
  若该合并提交来自Pull Request，可调用GET /repos/{owner}/{repo}/pulls/{pull_number}接口：

  • 查看mergeable字段的历史状态（不过该字段仅表示PR合并时是否存在冲突，合并后无法直接获取，但可结合PR的评论、事件记录辅助判断合并过程是否有冲突解决操作）。

GitHub UI里的“干净合并”判断逻辑，本质是对比合并提交的两个父提交，检查合并过程中是否需要手动解决冲突。如果无需手动干预直接完成合并，就是干净合并；若存在冲突并解决后再合并，提交的元数据和Diff会留下可识别的痕迹，通过上述API分析即可实现相同判断。

内容的提问来源于stack exchange，提问作者Surya