当使用更新版本的git（2.22+可能？）运行gitfilter分支时，它表示要使用这个新工具gitfilter repo。这个工具确实简化了我的工作。

使用过滤器回购进行过滤

根据原始问题创建XYZ回购的命令：

# create local clone of original repo in directory XYZ
tmp $ git clone git@github.com:user/original.git XYZ

# switch to working in XYZ
tmp $ cd XYZ

# keep subdirectories XY1 and XY2 (dropping ABC)
XYZ $ git filter-repo --path XY1 --path XY2

# note: original remote origin was dropped
# (protecting against accidental pushes overwriting original repo data)

# XYZ $ ls -1
# XY1
# XY2

# XYZ $ git log --oneline
# last commit modifying ./XY1 or ./XY2
# first commit modifying ./XY1 or ./XY2

# point at new hosted, dedicated repo
XYZ $ git remote add origin git@github.com:user/XYZ.git

# push (and track) remote master
XYZ $ git push -u origin master

假设：*远程XYZ回购是新的，在推送之前是空的

过滤和移动

在我的例子中，我还想移动几个目录以获得更一致的结构。最初，我运行简单的filter repo命令，然后运行git mv dir进行重命名，但我发现使用--path重命名选项可以获得稍微“更好”的历史记录。我去年（在GitHub UI中）看到的新回购中移动文件的修改时间与原始回购中的修改时间相匹配，而不是5小时前的最后一次修改。

而不是

git filter-repo --path XY1 --path XY2 --path inconsistent
git mv inconsistent XY3  # which updates last modification time

我最终跑了。。。

git filter-repo --path XY1 --path XY2 --path inconsistent --path-rename inconsistent:XY3

Notes:

我认为Git Rev News博客文章很好地解释了创建另一个回购过滤工具的原因。我最初尝试的路径是在原始存储库中创建一个与目标回购名称匹配的子目录，然后进行过滤（使用gitfilter repo--匹配新回购名称的子目录过滤器dir）。该命令正确地将该子目录转换为复制的本地repo的根目录，但它也只生成了创建子目录所需的三次提交的历史记录。（我没有意识到--路径可以多次指定；因此，不需要在源repo中创建子目录。）由于在我注意到我未能继续执行历史记录时，有人已经提交了源repo，所以我只在subdir move之前使用了git reset commit，在clone命令之后使用了，并在filter repo命令中添加了-force，以使其在稍微修改过的本地克隆上运行。

git clone ...
git reset HEAD~7 --hard      # roll back before mistake
git filter-repo ... --force  # tell filter-repo the alterations are expected

由于我不知道git的扩展模式，我在安装过程中遇到了困难，但最终我克隆了gitfilter repo并将其符号链接到$（git-exec路径）：

ln -s ~/github/newren/git-filter-repo/git-filter-repo $(git --exec-path)

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

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

编辑：添加了Bash脚本。

这里给出的答案对我来说只是部分奏效；缓存中仍有大量大文件。什么最终奏效了（在freenode上的#git中的几个小时后）：

git clone --no-hardlinks file:///SOURCE /tmp/blubb
cd blubb
git filter-branch --subdirectory-filter ./PATH_TO_EXTRACT  --prune-empty --tag-name-filter cat -- --all
git clone file:///tmp/blubb/ /tmp/blooh
cd /tmp/blooh
git reflog expire --expire=now --all
git repack -ad
git gc --prune=now

在以前的解决方案中，存储库大小约为100 MB。这一次将其降至1.7 MB。也许这对某人有帮助：）

---

以下bash脚本自动执行任务：

!/bin/bash

if (( $# < 3 ))
then
    echo "Usage:   $0 </path/to/repo/> <directory/to/extract/> <newName>"
    echo
    echo "Example: $0 /Projects/42.git first/answer/ firstAnswer"
    exit 1
fi


clone=/tmp/${3}Clone
newN=/tmp/${3}

git clone --no-hardlinks file://$1 ${clone}
cd ${clone}

git filter-branch --subdirectory-filter $2  --prune-empty --tag-name-filter cat -- --all

git clone file://${clone} ${newN}
cd ${newN}

git reflog expire --expire=now --all
git repack -ad
git gc --prune=now

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

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

https://github.com/slobobaby/git_filter

在GitHub上。

我希望它对某人有用。

简单的方法™

事实证明，这是一种非常普遍和有用的做法，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

您可以轻松尝试https://help.github.com/enterprise/2.15/user/articles/splitting-a-subfolder-out-into-a-new-repository/

这对我有用。我在上面给出的步骤中遇到的问题是

在此命令中，gitfilter branch--prune empty--子目录筛选器FOLDER-NAME branch-NAMEBRANCH-NAME是主如果由于保护问题提交时最后一步失败，请遵循以下步骤：https://docs.gitlab.com/ee/user/project/protected_branches.html