如何生成Git全量线性补丁链 使用git am在新仓库无冲突重建分支

核心疑问回复 #

• 关于是否存在可追溯到空仓库的线性提交历史：
  是。任意分支的提交链都可以沿着首个父节点路径追溯到根提交，再到空仓库状态，按该线性顺序应用diff即可还原分支当前状态。如果分支历史包含合并提交，直接全量遍历会出现多路径，不是天然线性，需要指定遍历规则明确线性路径。
• 关于能否通过git format-patch提取该线性历史：
  可以，但需要补充参数处理合并提交场景，默认git format-patch会跳过合并提交的差异导出，导致补丁序列不完整。
• 关于导出的补丁能否直接用于空仓库重建：
  只要补丁生成规则正确，完全可以无冲突重建，不需要复杂脚本。

冲突原因说明 #

当前操作出现冲突的核心原因是format-patch默认忽略了合并提交的改动：
如果你的branchX历史中存在合并节点，默认命令导出的补丁序列会缺失合并操作带来的代码变更，后续提交是基于合并后的代码状态修改的，应用到缺少合并改动的新仓库代码上自然会出现内容冲突。另外你尝试追加空状态提交哈希的操作完全多余，--root参数本身就会从分支的根提交开始导出补丁。

正确操作步骤 #

原仓库导出补丁 #

在repoA的branchX分支下执行：

# 仅保留branchX主线提交历史（合并进来的其他分支提交不会单独导出，保留主路径线性）
git --no-pager format-patch --binary --stdout --root --first-parent branchX > patch.list

如果你需要保留所有提交的完整线性历史，可以先将分支历史rebase为无合并的纯线性序列（会修改原分支提交哈希，操作前注意备份）：

git rebase --root --force-rebase branchX
# 再执行上面的format-patch导出命令

新仓库重建分支 #

cd /path/to/repoNew
git init
# 可选：配置和原仓库一致的用户信息，保证提交作者信息完全匹配
git config user.name "你的原仓库用户名"
git config user.email "你的原仓库提交邮箱"
# 应用补丁，参数处理空格、换行问题避免不必要的报错
git am --keep-cr --whitespace=nowarn patch.list

操作完成后新仓库的当前分支就和原仓库branchX的代码、提交历史完全一致。

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