PAYATHON 2026

如何在不触碰任何 worktree 或 tree/blob 对象的情况下执行 rebase?

技术问小赵

结论

git rebase 没有现成开关能保证整个过程完全不碰 worktree,同时让 tree/blob 对象保持不变。常规 git rebase 会执行 checkout、更新索引,并按合并结果生成新的 tree;-s ours 和 -X theirs 也不是为这个目的准备的。

如果你的目标只是重写 commit 对象之间的 parent 关系,并让每个新 commit 原样沿用旧 commit 的 tree,可以用底层 plumbing 命令 git commit-tree 手工重建提交链。整个过程不执行 checkout,不读写工作区,也不会新建 tree/blob,只创建新的 commit 对象,让它们引用已有的 tree。

这其实属于提交图重写,和通常说的 rebase 并不是一回事。它保留每个提交的文件快照,不会把旧提交的 diff/patch 重新应用到新 base 上。如果需要的是后者,就必须计算合并结果,通常会涉及新 tree,甚至需要临时索引或 worktree。

为什么 -s ours 和 -X theirs 不适合

-s ours 是 merge strategy,-X theirs 是 merge option。它们改变的是合并冲突或合并结果的处理方式,并不能保证 rebase 过程不碰 worktree。-s theirs 这个策略本身不存在。rebase 时,-s ours 里的 ours 还容易指向已经完成 rebase 的提交,所以它的含义并不是“原提交的 tree 保持不变”。-X theirs 仍可能触发 checkout。

操作步骤

  1. 先确定要重写的提交范围,例如 old_base..feature。建议在 bare 仓库里操作,或者只更新非当前分支,避免当前 worktree 与 HEAD 不一致。
  2. 从新 base 开始,按旧到新的顺序遍历原提交。
  3. 对每个原提交,用 git rev-parse ${c}^{tree} 取得 tree,再用 git commit-tree 把这个 tree 挂到新的 parent 上,生成新 commit。
  4. 用 git update-ref 把结果写到新分支或目标分支。不要直接用 git checkout 或 git reset --hard 同步工作区。

示例假设线性历史:

old_base=<旧父提交>
new_base=<新父提交>
feature=<要重写的分支>
parent=$(git rev-parse $new_base)

for c in $(git rev-list --reverse --first-parent $old_base..$feature); do
  tree=$(git rev-parse ${c}^{tree})
  author_name=$(git log -1 --format=%an $c)
  author_email=$(git log -1 --format=%ae $c)

  new_commit=$(git log -1 --format=%B $c | GIT_AUTHOR_NAME=$author_name GIT_AUTHOR_EMAIL=$author_email git commit-tree $tree -p $parent)
  parent=$new_commit
done

git update-ref refs/heads/rebased $parent

生成后可以用下面的命令验证 tree 是否被完全复用:

git rev-parse <旧提交>^{tree}
git rev-parse <新提交>^{tree}
git diff <旧提交>^{tree} <新提交>^{tree}

前两个 hash 应该相同,git diff 应该没有输出。用 git cat-file -p <新提交> 可以查看新的 parent。

注意事项

  • 示例只处理线性历史。遇到 merge 提交时,需要给 git commit-tree 传多个 -p,并自行决定保留 merge 结构还是压平;不要直接把 --first-parent 的结果当成完整历史。
  • 示例只设置了 author 信息,committer 默认是当前用户和当前时间。如果要保留原 committer 信息或时间,需要额外设置 GIT_COMMITTER_NAME、GIT_COMMITTER_EMAIL、GIT_COMMITTER_DATE。GPG 签名不会自动保留,需要重新签名。
  • 如果目标 ref 正是当前检出的分支,git update-ref 会改变 HEAD 指向但工作区不会同步,git status 会显示大量差异。更安全的做法是在 bare 仓库中操作,或只更新非当前分支。
  • 旧提交在 reflog 过期前仍可能可达。不要在不理解 reflog 和 gc 行为时清理仓库。
  • 这个方法不解决“把旧补丁合并到新 base”的问题;它只保证提交快照和 tree/blob 对象不变。

备注:内容仅供参考。