更新：这个过程非常常见，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所发现的，这会将项目分支和标记保留在新的回购中。

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

原始问题希望XYZ/ABC/（*文件）变为ABC/ABC/“*文件”。在为我自己的代码实现了公认的答案后，我注意到它实际上将XYZ/ABC/（*文件）更改为ABC/（*）文件。过滤器分支手册页甚至说，

结果将包含该目录（并且仅包含该目录）作为其项目根目录。"

换句话说，它将顶级文件夹“提升”一个级别。这是一个重要的区别，因为例如，在我的历史中，我重命名了一个顶级文件夹。通过将文件夹“提升”一级，git在我进行重命名的提交时失去了连续性。

我对这个问题的回答是制作存储库的两个副本，然后手动删除每个副本中要保留的文件夹。手册页支持我：

[…]如果一次简单的提交就足以解决您的问题，请避免使用[此命令]

在垃圾收集之前，您可能需要像“gitreflog-expire--expire=now--all”这样的内容来实际清理文件。gitfilter分支只删除历史记录中的引用，但不删除保存数据的reflog条目。当然，先测试一下。

尽管我的初始条件有所不同，但我的磁盘使用量在这样做时大幅下降。也许--子目录过滤器否定了这种需要，但我对此表示怀疑。

简单的方法™

事实证明，这是一种非常普遍和有用的做法，Git的霸主们让它变得非常简单，但你必须有一个新版本的Git（>=1.7.11 May 2012）。有关如何安装最新的Git，请参阅附录。此外，下面的演练中有一个真实世界的示例。

准备旧回购cd<大回购>git子树拆分-P<文件夹名称>-b<新分支名称>

注意：＜文件夹名称＞不能包含前导或尾随字符。例如，名为subject的文件夹必须作为子项目传递，而不是/子项目/

Windows用户注意：当文件夹深度>1时，＜文件夹名称＞必须具有*nix样式的文件夹分隔符（/）。例如，名为path1\path2\subject的文件夹必须作为path1/path2/subject传递

创建新回购mkdir~/<new repo>&&cd~/<newrepo>初始化git pull＜/path/to/big repo＞＜新分支的名称＞将新回购链接到GitHub或任何地方git远程添加原点<git@github.com：user/new repo.git>git push-u原始主机如果需要，清理<big repo>内部gitrm-rf＜文件夹名称＞

注意：这会将所有历史引用保留在存储库中。如果您确实担心提交了密码或需要减小.git文件夹的文件大小，请参阅下面的附录。

---

演练

这些步骤与上面的步骤相同，但遵循我对存储库的确切步骤，而不是使用＜meta-named things＞。

下面是我在node中实现JavaScript浏览器模块的项目：

tree ~/node-browser-compat

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

我想将一个文件夹btoa拆分成一个单独的Git存储库

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

我现在有了一个新的分支，仅限btoa，它只有btoa的提交，我想创建一个新存储库。

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

接下来，我在GitHub或Bitbucket上创建一个新的repo，并将其添加为源代码

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

快乐的一天！

注意：如果您使用README.md、.gitignore和LICENSE创建了一个repo，则需要首先执行以下操作：

git pull origin master
git push origin master

最后，我想从更大的存储库中删除该文件夹

git rm -rf btoa

---

附录

macOS上的最新Git

要使用Homebrew获取最新版本的Git：

brew install git

Ubuntu上的最新Git

sudo apt-get update
sudo apt-get install git
git --version

如果这不起作用（你有一个非常旧的Ubuntu版本），请尝试

sudo add-apt-repository ppa:git-core/ppa
sudo apt-get update
sudo apt-get install git

如果仍然不起作用，请尝试

sudo chmod +x /usr/share/doc/git/contrib/subtree/git-subtree.sh
sudo ln -s \
/usr/share/doc/git/contrib/subtree/git-subtree.sh \
/usr/lib/git-core/git-subtree

谢谢你的评论。

清除您的历史记录

默认情况下，从Git中删除文件并不会真正删除它们，它只是表明它们不再存在。如果您想要实际删除历史引用（即您提交了密码），则需要执行以下操作：

git filter-branch --prune-empty --tree-filter 'rm -rf <name-of-folder>' HEAD

之后，您可以检查您的文件或文件夹是否不再显示在Git历史记录中

git log -- <name-of-folder> # should show nothing

但是，您不能将删除内容“推送”到GitHub等。如果你尝试了，你会得到一个错误，你必须先得到pull，然后才能得到push，然后你就回到了你的历史中。

因此，如果你想从“源”中删除历史记录-意思是从GitHub、Bitbucket等中删除它-你需要删除回购，并重新推送一个经过修剪的回购副本。但等等-还有更多！-如果你真的担心删除密码或类似的东西，你需要删除备份（见下文）。

使.git变小

前面提到的delete history命令仍然会留下一堆备份文件，因为Git非常友好，可以帮助您避免意外破坏回购。它最终会在几天和几个月内删除孤立的文件，但它会在一段时间内将它们留在那里，以防您意识到您无意中删除了一些您不想删除的文件。

所以，如果你真的想清空垃圾箱以立即减少回购的克隆大小，你必须做所有这些非常奇怪的事情：

rm -rf .git/refs/original/ && \
git reflog expire --all && \
git gc --aggressive --prune=now

git reflog expire --all --expire-unreachable=0
git repack -A -d
git prune

也就是说，我建议您不要执行这些步骤，除非您知道需要执行这些步骤——以防万一您确实删除了错误的子目录，知道吗？当您推送回购时，备份文件不应该被克隆，它们只会在您的本地副本中。

信用

http://psionides.eu/2010/02/04/sharing-code-between-projects-with-git-subtree/从git中永久删除目录http://blogs.atlassian.com/2013/05/alternatives-to-git-submodule-git-subtree/如何从git repo中删除未引用的Blob

查看git_split项目https://github.com/vangorra/git_split

在自己的位置将git目录转换为自己的存储库。没有子树有趣的业务。该脚本将获取git存储库中的现有目录，并将该目录转换为独立的存储库。在此过程中，它将复制您提供的目录的整个更改历史记录。

./git_split.sh <src_repo> <src_branch> <relative_dir_path> <dest_repo>
        src_repo  - The source repo to pull from.
        src_branch - The branch of the source repo to pull from. (usually master)
        relative_dir_path   - Relative path of the directory in the source repo to split.
        dest_repo - The repo to push to.

这里的大多数答案似乎都依赖于某种形式的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文件夹中节省任何空间，但它会保留这些文件的所有更改历史记录，即使是跨重命名。如果没有“很多”历史记录丢失等，这可能不值得。但至少可以保证您不会丢失以前的提交！