GitHub API与网页commit顺序不一致问题求助

问题根源 #

核心问题出在Git提交的多父节点特性：仓库存在合并操作时，一个commit可能对应多个父节点。GitHub网页默认展示当前分支（比如main/master）的线性提交历史，而直接通过commit SHA调用API查询父节点时，返回的可能是合并commit的非主分支父节点，而非网页显示的主分支前序提交。

你提到的mui/material-ui仓库里的8659c6991adb9e2f83a8f3af6bd90321adfe8f68就是个合并commit，它的parents数组包含两个父节点：一个是被合并分支的节点f2ed40aac85f8e69bb44e4f21c12ced40d1b11a5，另一个就是网页显示的主分支前序节点dedcf74。

关于parents字段的说明 #

• 它是数组的原因：Git里普通提交只有1个父节点，但合并提交会有2个甚至更多父节点（对应被合并的多个分支），API会返回所有父节点的SHA值。
• 网页显示的前序提交，其实是当前分支提交链上的直接前驱，也就是合并commit中属于主分支的那个父节点。

解决方案：获取和网页一致的线性提交历史 #

要拿到和网页顺序一致的commit列表，别单独查询单个commit的父节点，直接获取目标分支的完整提交历史就行：

1. 按分支名拉取线性提交历史
   用GitHub API的「获取分支提交」接口，指定你要分析的分支（比如main），返回的commit序列和网页展示完全一致：

   GET /repos/mui/material-ui/commits?sha=main
   

   这个列表里的每个commit，前序就是网页显示的那个，不用处理多父节点的麻烦。

2. 适配二分查找的优化
   要是你需要用二分查找定位重构的关键commit，直接基于这个分支commit列表做二分即可。如果要验证某个commit是否在主分支的提交链里，可以检查它是否在返回的列表中，或者借助API的祖先节点判断逻辑辅助验证。

3. 单独查询单个commit的主分支前驱
   要是必须单独查某个commit的主分支前序，可以先拿到分支的提交历史列表，然后找到该commit在列表中的下一个条目（因为列表是从新到旧排序的）；或者借助Git的祖先节点判断逻辑，通过API参数筛选出主分支上的前驱。

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