如何将含提交/分支及其子项的提交树变基至无关分支？

要实现把以B为根的整个提交树（包含所有子分支）迁移到无关分支O、且完整保留原有分支结构的需求，最可靠且适合批量分支场景的方法是使用git filter-repo——这是Git官方推荐的历史重写工具，完美支持你的Debian服务器和Windows Git SDK环境。以下是详细实操步骤：

前提准备 #

1. 务必备份仓库：历史重写操作不可逆，建议先克隆一个本地副本测试，或创建全局备份分支：

   git branch backup-full-history
   

2. 获取关键提交哈希：先拿到目标根提交B、目标父分支O，以及B原来的父提交A的哈希值（也可以直接用分支名，只要分支名唯一）：

   # 获取B的提交哈希
   B_HASH=$(git rev-parse B)
   # 获取O的提交哈希
   O_HASH=$(git rev-parse O)
   # 获取B原来的父提交A的哈希
   A_HASH=$(git rev-parse B^)
   

3. 确保git filter-repo可用：
   • Debian服务器：执行sudo apt install git-filter-repo安装
   • Windows Git SDK：默认已自带，可通过git filter-repo --version验证可用性

执行迁移操作 #

运行以下命令，仅修改B提交的父节点（从A替换为O），其余所有提交的父关系保持不变，从而完整保留分支结构：

git filter-repo --parent-filter '
if [ "$GIT_COMMIT" = "$B_HASH" ]; then
  sed "s/^\(parent \)$A_HASH$/\1$O_HASH/"
else
  cat
fi
'

命令逻辑解释 #

• --parent-filter：遍历仓库所有提交，仅对指定提交的父节点进行修改
• 只针对B提交操作：把它原来的父提交A替换成目标分支O
• 其他提交的父关系完全保留，因此B的所有子分支（D/E/H/I等）会自动挂到新的提交树下，结构和原提交链完全一致

验证迁移结果 #

执行完命令后，用git log --graph --oneline查看提交树，你会看到完全符合预期的结构：

• O作为新的根节点，直接衔接B提交
• B之后的主提交链C-F-G-J-K完整保留
• B分出的D-E分支、F分出的H-I分支结构没有任何变化

后续收尾操作 #

1. 清理旧分支/提交：如果不再需要原来的A及相关旧分支，可执行删除：

   # 删除本地旧分支（示例中假设旧主分支为main）
   git branch -D main
   # 删除远程旧分支（谨慎操作，确保团队成员知情）
   git push origin --delete main
   

2. 推送新分支到远程：因为历史已重写，需要强制推送所有迁移后的分支：

   # 批量推送所有本地分支到远程（替换为你的远程仓库名，比如origin）
   git push --force origin $(git branch --format='%(refname:short)')
   

备选方案：原生Git脚本（无filter-repo场景） #

如果因环境限制无法使用git filter-repo，可以通过脚本批量执行git rebase，但需要严格按分支依赖顺序处理（先父分支、后子分支）：

# 按依赖顺序定义要迁移的分支列表
branches=("B" "D" "E" "C" "F" "H" "I" "G" "J" "K")
# 记录旧B的哈希
OLD_B_HASH=$(git rev-parse B)

# 先处理B分支，将其变基到O上
git checkout B
git rebase --onto O A B
# 记录新B的哈希
NEW_B_HASH=$(git rev-parse B)

# 处理依赖B的子分支D、E
for branch in "D" "E"; do
  git checkout $branch
  git rebase --onto $NEW_B_HASH $OLD_B_HASH $branch
done

# 继续处理后续分支，依次替换旧父哈希为新父哈希
OLD_C_HASH=$(git rev-parse C)
git checkout C
git rebase --onto $NEW_B_HASH $OLD_B_HASH C
NEW_C_HASH=$(git rev-parse C)

# 以此类推处理F、H、I等后续分支

注意：这个方案需要手动维护分支依赖顺序，分支数量多的时候非常繁琐，因此优先推荐git filter-repo方法。

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