如何在Mercurial/Hg中改写非线性版本历史？

我需要隐藏一个拓扑头（特性分支合并后遗留的未纳入合并的提交），同时不破坏历史图的展示效果。常规方案是把关闭分支的提交合并回default，但这会在长达10年的项目历史中添加额外边，打乱hg glog的输出。

我想重写项目历史，把这个关闭提交移到集成合并到default之前的位置。但RebaseExtension和HisteditExtension似乎只支持处理线性历史，而集成合并前后的历史结构比较复杂。

具体来说，我需要将提交C移到F和M之间：

原历史结构：

*B
 |
 *M(erge)
 |\   *C(losing)
 | \/
A*  *F(eature)

目标历史结构（C'、M'、B'仅哈希值改变）：

*B'
  |
  *M'(erge)
  /\ 
A*  *C'(losing)
    |
    *F(eature)

解决方案 #

要实现这种非线性历史的改写，可以通过Mercurial的rebase命令结合分支保留选项，或者使用histedit的交互式编辑来调整提交顺序，以下是具体步骤：

方法一：使用rebase调整提交位置 #

• 确保本地仓库无未提交修改：

  hg status
  

• 将提交C变基到F上方，保留分支结构：

  hg rebase --source C --dest F --keepbranches
  

• 切换到主分支的A节点，合并变基后的C'：

  hg update A
  hg merge C'
  # 解决冲突后提交合并，备注与原M一致
  hg commit -m "Merge feature branch"
  

• 将原提交B变基到新的合并提交M'上：

  hg rebase --source B --dest M'
  

方法二：使用histedit交互式编辑历史 #

• 确保已启用HisteditExtension（未启用则在.hgrc中添加配置）：

  [extensions]
  histedit =
  

• 启动针对B节点的历史编辑：

  hg histedit B
  

• 在编辑界面中调整提交顺序：
  • 将C的动作改为move，移至F之后、M之前
  • 修改M的合并父节点为A和新位置的C'
  • 保存退出，Mercurial会自动重写历史
• 若遇冲突，解决后继续执行：

  hg histedit --continue
  

重要注意事项 #

• 重写后被修改的提交哈希会全部变更，需通知团队成员重新拉取，避免历史冲突
• 禁止对已推送到公共仓库的历史执行重写操作，除非团队全员知情同意
• 操作前务必备份仓库，防止数据丢失

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