如何仅将一个 Git 仓库的一部分(子集，文件夹)迁移到另一个仓库并保留提交记录

我有一个 Git 存储库，其中包含许多子目录。现在，我发现一个子目录与另一个子目录无关，应该将其分离到单独的存储库中。

如何在保留子目录中文件历史记录的同时执行此操作？

为了清楚起见，假如项目结构为

XYZ/
    .git/
    XY1/
    ABC/
    XY2/

分离后的项目结构为

XYZ/
    .git/
    XY1/
    XY2/ 
ABC/
    .git/
    ABC/

下面将介绍一种简单的方式来实现分离。

其实这种情况非常普遍，以至于 Git 团队提供了一个新的命令 git subtree 来处理这种情况。需 Git 版本 >= 1.7.11。

1 2	cd <big-repo> git subtree split -P <name-of-folder> -b <name-of-new-branch>

注意： <name-of-folder> 不得包含前导或尾随字符。例如，subproject 的参数必须为 subproject，而不是./subproject/

Windows 用户注意事项：当文件夹深度> 1时，<name-of-folder> 必须使用文件夹分隔符（/）。例如，名为path1\path2\subproject 的文件夹则参数必须为 path1/path2/subproject

1
2
3

mkdir ~/<new-repo> && cd ~/<new-repo>
git init
git pull </path/to/big-repo> <name-of-new-branch>

1 2	git remote add origin <git@github.com:user/new-repo.git> git push -u origin master

如果需要删除 <big-repo> 中的目录，可以执行

1 2	git rm -rf <name-of-folder> git push

项目目录如下

tree ~/node-browser-compat

node-browser-compat
├── ArrayBuffer
├── Audio
├── Blob
├── FormData
├── atob
├── btoa
├── location
└── navigator

我想将 btoa 目录拆分为单独的 Git 存储库

1 2	cd ~/node-browser-compat/ git subtree split -P btoa -b btoa-only

现在，我有了一个新分支，btoa-only 该分支仅具有提交功能，并且我想创建一个新的存储库。

1
2
3

mkdir ~/btoa/ && cd ~/btoa/
git init
git pull ~/node-browser-compat btoa-only

接下来，我在 GitHub 或 Gitlab 上创建一个新的仓库，或将其添加为 origin

1 2	git remote add origin git@github.com:node-browser-compat/btoa.git git push -u origin master

最后，我要从原仓库中删除文件夹

1	git rm -rf btoa