首页/开发/Git 与协作速查/git rebase --update-refs 同步堆叠分支
合并变基与冲突71 条

git rebase --update-refs 同步堆叠分支

变基时同步更新下游分支引用,保持堆叠分支(stacked branches)的父子关系;Git 2.38 起可用。

Git 与协作速查开发更新于 2026-10-12
用途重放提交时顺带更新指向这些提交的其他分支
语法git rebase --update-refs <上游>
版本Git 2.38+;持久化配置 rebase.updateRefs

常用示例

常用示例
git config rebase.updateRefs true
git switch feature/base
git rebase origin/main
git branch -vv
适合把一个堆叠分支链整体移到新主干上,省去逐个手动变基;完成后用 git log --graph 核对各分支位置。

易错点

  • 会让原本只打算改一条分支的操作顺带移动其他分支,执行前确认分支指针都在预期位置
  • 旧版 Git 忽略该选项(或无此参数),跨团队需确认版本基线

数据来源与参考

  • Git 官方文档:git-rebase(--update-refs)
  • Git 2.38 Release Notes
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌