Git如何将一个分支的完整状态复制到另一分支并保留提交历史

需求背景 #

• 现有两个Git分支：branch-a、branch-b
• 目标：保留branch-a的全部原有提交历史，同步后branch-a的文件结构、内容与branch-b完全一致，最终生成一个新的同步提交
• 已验证不可行的方案缺陷：
  • 直接执行git checkout branch-b -- .拉取文件：无法同步branch-b中已删除的文件，branch-a中独有的冗余文件会被保留
  • 直接执行merge合并：会自动保留branch-a独有、branch-b已删除的无冲突文件，无法达到文件完全一致的效果

可直接复用的操作方案 #

方案1：底层命令高效实现（推荐） #

适合熟悉Git操作的场景，没有多余文件操作，执行速度快：

# 切换到需要保留历史的目标分支
git checkout branch-a

# 将暂存区、工作区完全替换为branch-b的状态，自动处理所有文件增/删/改
git read-tree --reset -u branch-b

# 提交同步变更，新提交的父节点为branch-a原有最新提交，历史记录完整保留
git commit -m "Sync all files to exactly match branch-b"

方案2：新手友好实现 #

步骤直观好记，不需要记忆Git底层命令，最终效果和方案1完全一致：

# 切换到需要保留历史的目标分支
git checkout branch-a

# 删除当前分支所有已跟踪文件，清空原有文件残留
git rm -rf .

# 从branch-b拉取全量文件覆盖到工作区
git checkout branch-b -- .

# 提交所有变更（包含文件新增、修改、删除操作）
git commit -m "Sync all files to exactly match branch-b"

原理说明 #

• 方案1的git read-tree --reset -u branch-b会直接读取branch-b对应的完整文件树到暂存区，-u参数同步更新工作区文件，--reset参数会覆盖本地未提交变更，执行完成后暂存区、工作区和branch-b完全一致，但HEAD指针依然停在branch-a原有的最新提交位置，提交后不会破坏原有历史。
• 方案2先清空branch-a所有已跟踪文件，从根源避免了直接checkout无法同步删除操作的问题，再拉取branch-b全量文件后，工作区状态和branch-b完全一致。

注意：以上操作会覆盖branch-a上所有未提交的本地变更，如果有未保存的重要内容，请提前备份或提交到临时分支保存。

避坑提醒 #

不要直接使用git reset --hard branch-b，该命令会直接将branch-a的HEAD指针移动到branch-b的最新提交位置，导致branch-a原有提交历史被覆盖，不符合需求。

内容的提问来源于stack exchange，提问作者Juan Enrique Muñoz Zolotoochin