GitButler项目中编辑堆叠分支提交时的冲突问题分析

问题现象

在使用GitButler工具时，当用户尝试编辑堆叠分支(stacked branch)中的中间提交时，会出现一个奇怪的现象：编辑后的提交会在顶部堆叠分支中出现，而原始提交仍保留在中间堆叠分支中，导致提交记录出现重复。这种情况在Linux系统上使用0.14.13版本的GitButler AppImage时被报告。

问题复现步骤

1. 创建一个包含3个堆叠分支的虚拟分支
2. 在每个堆叠分支中添加1个提交
3. 将这些提交推送到远程仓库
4. 编辑中间分支中的一个提交并提交修改
5. 观察结果：顶部堆叠分支包含编辑后的提交，而中间堆叠分支仍保留原始提交

技术背景

堆叠分支是Git工作流中的一种高级用法，它允许开发者维护一系列相互依赖的分支。当修改其中一个分支的提交时，理论上应该自动更新所有依赖该提交的上游分支。GitButler作为Git工作流增强工具，旨在简化这类复杂操作。

问题根源

根据GitButler开发团队的分析，这个问题可能与历史重写功能cherry_rebase_group的实现有关。在代码中多处使用该函数重写历史时，没有正确更新堆叠分支的头部引用。这导致了提交编辑后，分支间的同步出现不一致。

解决方案

开发团队已经通过以下方式解决了这个问题：

1. 逐步淘汰cherry_rebase_group函数的使用
2. 改用更可靠的rebase引擎来处理历史重写
3. 确保在重写操作后正确更新所有相关的堆叠分支头部

该修复已包含在0.14.14版本中。对于遇到此问题的用户，升级到最新版本即可解决。

临时解决方法

在修复版本发布前，用户可以采取以下临时措施：

1. 将顶部堆叠分支中的重复提交拖拽到原始提交的正下方位置
2. 然后取消顶部重复提交的提交状态
3. 注意避免其他操作，否则可能导致更复杂的冲突

总结

堆叠分支操作是Git工作流中的高级功能，工具需要精确处理分支间的依赖关系。GitButler团队通过重构底层引擎，解决了编辑提交时的同步问题，提升了工具的稳定性。这体现了开源项目通过社区反馈持续改进的典型过程。