合并有共同祖先的分叉Git仓库并保留双方独立文件系统的方案

你当前采用的grafts配置+filter-branch改写历史的方式可以实现需求，但属于侵入式修改原有提交链的方案，存在提交元数据丢失、签名失效的风险，有更规范、风险更低的实现方式，不需要篡改原有仓库的提交逻辑，就能保证两个分叉项目以完整状态并入，不会触发Git的自动三向合并修改文件。

直接合并存在共同祖先的两个分叉分支时，Git会基于共同祖先做三向diff，就算提前把已合入的项目移到了子目录，待合入分支的提交历史里文件还是存在根目录路径，Git会判定根目录同名文件存在两边的变更记录，自动尝试合并，才会出现不符合预期的文件篡改。

方案一：保留全量提交历史的规范方案 #

如果需要保留两个项目的所有提交历史，优先用路径预重写的方式处理，核心逻辑是在合入前将待合并仓库的全量提交的文件路径统一重写到专属子目录，重写后提交哈希会全部变更，自然切断和已合入仓库的共同提交关联，不会触发跨项目的文件合并。
操作步骤：

• 先在本地单独拉取待合并的fork仓库副本，不要直接在原仓库或monorepo主分支操作，避免影响原有代码
• 使用Git官方推荐的git filter-repo工具（替代老旧的filter-branch，稳定性和处理速度更优）对fork仓库做全历史路径重写，将所有文件迁移到规划好的专属子目录，比如project-fork/：

  git filter-repo --to-subdirectory-filter project-fork/
  

• 把路径重写后的fork仓库作为远程源添加到monorepo中，拉取重写后的分支
• 确认monorepo中已合入的原项目已经移动到专属子目录（比如project-origin/），两个项目的文件路径完全无重叠，直接执行合并即可：

  git merge <fork重写后分支名> --allow-unrelated-histories
  

  该操作只会新增project-fork/下的所有文件，不会对已有文件做任何合并修改。

方案二：仅保留最新代码快照的轻量方案 #

如果不需要保留fork仓库的历史提交，只需要把当前版本的代码完整并入，操作更简单，完全不需要修改任何原有提交历史：

• 在monorepo中基于fork仓库的最新代码创建孤儿分支，孤儿分支没有任何父提交，天然不存在和其他分支的共同祖先：

  git switch --orphan fork-temp
  git reset --hard
  

• 将fork仓库的全量代码复制到该分支下，整体移入规划好的project-fork/子目录，提交变更：

  git add project-fork/
  git commit -m "Import fork project latest snapshot"
  

• 切回monorepo主分支，合并临时孤儿分支，完成后删除临时分支即可：

  git switch main
  git merge fork-temp --allow-unrelated-histories
  git branch -D fork-temp
  

现有临时方案的优化建议 #

你当前使用的grafts+filter-branch方案本质是通过改写提交祖先链切断共同提交关联，逻辑可行但filter-branch属于官方不推荐的老旧工具，容易出现提交信息丢失、合并冲突异常的问题，如果坚持使用改历史的路线，可以把filter-branch替换为git filter-repo实现等价的祖先切断逻辑，稳定性更高。

注意：所有涉及历史重写的操作，都要提前做好仓库备份，避免误操作导致提交记录丢失。

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