发现这篇精彩的文章原创参考很容易理解。记录在这里，以防无法访问。

1.准备当前存储库

$ cd path/to/repository
$ git subtree split -P my-folder -b my-folder
Created branch 'my-folder'
aecbdc3c8fe2932529658f5ed40d95c135352eff

文件夹的名称必须是相对路径，从存储库的根目录开始。

2.创建新存储库

$ cd my-folder
$ git init
Initialized empty Git repository in /Users/adamwest/Projects/learngit/shop/my-folder/.git/
$ git add .
$ git commit -m "initial commit"
[master (root-commit) 192c10b] initial commit
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 file

这里我们只需要cd到新文件夹，初始化新存储库，并提交任何内容。

3.添加新的远程存储库并推送

$ git remote add origin git@github.com:robertlyall/my-folder.git
$ git push origin -u master
Enumerating objects: 3, done.
Counting objects: 100% (3/3), done.
Writing objects: 100% (3/3), 199 bytes | 199.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To github.com:robertlyall/my-folder.git
 * [new branch]      master -> master
Branch 'master' set up to track remote branch 'master' from 'origin'.

我们在这里添加远离GitHub的新存储库，然后推送我们的第一次提交。

4.从主存储库中删除文件夹并推送

$ cd ../
$ git rm -rf my-folder
rm 'my-folder/file'
$ git commit -m "Remove old folder"
[master 56aedbe] remove old folder
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 my-folder/file
$ git push
Enumerating objects: 3, done.
Counting objects: 100% (3/3), done.
Delta compression using up to 4 threads
Compressing objects: 100% (2/2), done.
Writing objects: 100% (2/2), 217 bytes | 217.00 KiB/s, done.
Total 2 (delta 1), reused 0 (delta 0)
remote: Resolving deltas: 100% (1/1), completed with 1 local object.
To github.com:robertlyall/shop.git
   74dd8b3..56aedbe  master -> master

最后，我们cd回到rooot目录，从主存储库中删除文件夹，然后提交并推送更改。现在，我们的主存储库中有一个文件夹，但它链接到一个完全独立的存储库，可以在多个项目中重用。

更新：这个过程非常常见，git团队用一个新工具git子树简化了这个过程。请参阅此处：将子目录分离（移动）到单独的Git存储库中

您希望克隆存储库，然后使用gitfilter分支标记除要在新存储库中进行垃圾收集的子目录之外的所有内容。

要克隆本地存储库，请执行以下操作：gitclone/XYZ/ABC（注意：将使用硬链接克隆存储库，但这不是问题，因为硬链接文件本身不会被修改-将创建新的文件。）现在，让我们保留我们想要重写的有趣分支，然后删除源，以避免推到那里，并确保源不会引用旧的提交：cd/ABC对于分支1 br2 br3中的i；do git branch-t$i原点/$i；完成git远程rm源或对于所有远程分支：cd/ABC对于$中的i（git branch-r|sed“s/.*origin\///”）；do git branch-t$i原点/$i；完成git远程rm源现在，您可能还想删除与子项目无关的标记；你也可以稍后再做，但你可能需要再次修剪你的repo。我没有这样做，并得到一个警告：Ref‘refs/tags/v0.1‘对于所有标签都是不变的（因为它们都与子项目无关）；此外，在移除这些标签之后，将回收更多的空间。显然，gitfilter分支应该能够重写其他标记，但我无法验证这一点。如果要删除所有标记，请使用git-tag-l|xargs-git-tag-d。然后使用过滤器分支和重置来排除其他文件，以便可以对它们进行修剪。还让我们添加--tag-namefilter-cat--pruneempty以删除空提交并重写标记（注意，这将不得不去掉它们的签名）：gitfilter branch--标记名filter cat--修剪空--子目录筛选器ABC----全部或者替代地，只重写HEAD分支并忽略标记和其他分支：gitfilter branch--标记名filter cat--修剪空--子目录筛选器ABC HEAD然后删除备份回流，以便真正回收空间（尽管现在操作是破坏性的）git重置--硬git for each ref--format=“%（refname）”refs/original/| xargs-n 1 git update ref-dgit reflog expire--expire=现在--全部git-gc--aggressive--prune=现在现在您有了ABC子目录的本地git存储库，并保留了其所有历史记录。

注意：对于大多数用途，gitfilter分支确实应该添加参数--all。是的，那真的是——空间——全部。这需要是命令的最后一个参数。正如Matli所发现的，这会将项目分支和标记保留在新的回购中。

编辑：以下评论中的各种建议都被纳入其中，以确保存储库实际上已经缩小（以前并非如此）。

我确实遇到了这个问题，但所有基于gitfilter分支的标准解决方案都非常缓慢。如果你有一个小的存储库，那么这可能不是问题，这是我的问题。我基于libgit2编写了另一个git过滤程序，作为第一步，它为主存储库的每个过滤创建分支，然后作为下一步将这些分支推送到清理存储库。在我的存储库中（500Mb100000次提交），标准的gitfilter分支方法花费了几天时间。我的程序需要几分钟来完成相同的过滤。

它有一个神话般的名字git_filter，住在这里：

https://github.com/slobobaby/git_filter

在GitHub上。

我希望它对某人有用。

把这个放到你的gitconfig中：

reduce-to-subfolder = !sh -c 'git filter-branch --tag-name-filter cat --prune-empty --subdirectory-filter cookbooks/unicorn HEAD && git reset --hard && git for-each-ref refs/original/ | cut -f 2 | xargs -n 1 git update-ref -d && git reflog expire --expire=now --all && git gc --aggressive --prune=now && git remote rm origin'

这里的大多数答案似乎都依赖于某种形式的gitfilter分支——子目录筛选器及其类似的分支。这可能在“大多数情况下”有效，但在某些情况下，例如重命名文件夹时，例如：

 ABC/
    /move_this_dir # did some work here, then renamed it to

ABC/
    /move_this_dir_renamed

如果您使用普通的git过滤器样式来提取“move_this_dir重命名”，则会丢失最初为“move_this_dir”（ref）时发生的文件更改历史记录。

因此，似乎真正保留所有更改历史的唯一方法（如果您的情况是这样的），本质上就是复制存储库（创建一个新的repo，将其设置为原点），然后对所有其他内容进行核处理，并将子目录重命名为父目录，如下所示：

在本地克隆多模块项目分支-检查有什么：gitbranch-a对要包含在拆分中的每个分支进行签出，以在您的工作站上获得本地副本：gitcheckout--trackorigin/branchABC在新目录中创建副本：cp-r oldmultimodsimple进入新项目副本：cd simple删除此项目中不需要的其他模块：git rm other模块1 other2 other3现在只剩下目标模块的子磁盘删除模块子目录，使模块根目录成为新的项目根目录git-mv模块Subdir1/*。删除遗迹子目录：rmdir moduleSubdir1随时检查更改：git状态创建新的git repo并复制其URL以将此项目指向其中：git远程设置url源http://mygithost:8080/git/our-分裂模块回购验证这是否正确：gitremote-v将更改推送到远程存储库：git Push转到远程回购并检查所有内容对所需的任何其他分支重复此操作：git checkout branch2

接下来是github文档“将子文件夹拆分为新存储库”的步骤6-11，以将模块推送到新存储库。

这不会在.git文件夹中节省任何空间，但它会保留这些文件的所有更改历史记录，即使是跨重命名。如果没有“很多”历史记录丢失等，这可能不值得。但至少可以保证您不会丢失以前的提交！

正确的方法如下：

git filter branch--修剪空--子目录筛选器FOLDER_NAME[first_branch][another_branch]

GitHub现在甚至有关于此类案例的小文章。

但一定要先将原始存储库克隆到单独的目录中（因为这会删除所有文件和其他目录，您可能需要使用它们）。

所以你的算法应该是：

将远程存储库克隆到另一个目录使用gitfilter分支只在某些子目录下留下文件，推送到新的远程创建提交以从原始远程存储库中删除此子目录