git move files to new repo with history Jan 19, 2026

使用 git subtree 拆分文件到新仓库并保留文件历史修改记录：

假设你需要对现存的大仓库 A 进行功能拆分，把其中的某一个模块代码完全迁移出来单独维护，但是同时你又想要保留这些文件的历史修改记录：操作方式如下：

比如需要从 A 仓库里抽出 sub 模块的所有代码单独用新仓库维护：

1.首先进入到 A 仓库，通过这个 subtree 命令把 src/sub 目录下的代码提取出来，生成一个新的分支 drain_sub：

git subtree split --prefix=src/sub -b drain_sub

这个过程会比较慢，因为需要遍历整个提交历史，1000+的commit，把和 src/sub 目录相关的提交都提取出来，建立了一个新的子树分支，里面只包含 src/sub 目录下的代码和相关的提交记录。

耗时7min运行完成后，可以通过以下命令看出来这个分支有200多个提交

git log drain_sub --oneline | wc -l

2.切换目录去在新仓库里：

把这个抽出来的分支当作一个远程分支拉取进来，因为没有任何共同历史，所以需要加上 --allow-unrelated-histories 参数：

git pull ../A drain_sub --allow-unrelated-histories

你就得到了一个包含所有提交历史的sub merge结果分支。

3.但是这些文件大概率还不在你需要它们在的位置上，需要把它们移动到 sub/src 目录下，用 git mv 移动一下单独再提交一个提交来尽可能让git维持文件历史：

mkdir -p sub/src



# 记得过滤掉不相关的文件，只移动需要的

find . -maxdepth 1 ! -name 'sub' ! -name '.git' ! -name '.' ! -name 'README.md' -exec git mv {} ./sub/src/ \;

git commit -m "Move sub files to sub/src directory"