简单易行™

事实证明，这是一种常见且有用的做法，Git的主宰们使其变得非常简单（在1.7.11版本中添加-2012年5月）。此外，在下面的演示中还有一个真实世界的例子。

步骤说明

这些是与上述步骤相同的步骤，但是按照我的存储库的确切步骤进行，而不是使用<meta-named-things>。

这是一个我用于在Node中实现JavaScript浏览器模块的项目：

tree ~/node-browser-compat

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

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

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

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

git pull origin master
git push origin master

git rm -rf btoa

清除浏览历史

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

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

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

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仓库中删除未引用的blob

您希望克隆存储库，然后使用 git filter-branch 将除了您想要的子目录以外的所有东西标记为垃圾，以便在新的存储库中进行垃圾回收。

1. To clone your local repository:

   git clone /XYZ /ABC
   

   (Note: the repository will be cloned using hard-links, but that is not a problem since the hard-linked files will not be modified in themselves - new ones will be created.)

2. Now, let us preserve the interesting branches which we want to rewrite as well, and then remove the origin to avoid pushing there and to make sure that old commits will not be referenced by the origin:

   cd /ABC
   for i in branch1 br2 br3; do git branch -t $i origin/$i; done
   git remote rm origin
   

   or for all remote branches:

   cd /ABC
   for i in $(git branch -r | sed "s/.*origin\///"); do git branch -t $i origin/$i; done
   git remote rm origin
   

3. Now you might want to also remove tags which have no relation with the subproject; you can also do that later, but you might need to prune your repo again. I did not do so and got a WARNING: Ref 'refs/tags/v0.1' is unchanged for all tags (since they were all unrelated to the subproject); additionally, after removing such tags more space will be reclaimed. Apparently git filter-branch should be able to rewrite other tags, but I could not verify this. If you want to remove all tags, use git tag -l | xargs git tag -d.

4. Then use filter-branch and reset to exclude the other files, so they can be pruned. Let's also add --tag-name-filter cat --prune-empty to remove empty commits and to rewrite tags (note that this will have to strip their signature):

   git filter-branch --tag-name-filter cat --prune-empty --subdirectory-filter ABC -- --all
   

   or alternatively, to only rewrite the HEAD branch and ignore tags and other branches:

   git filter-branch --tag-name-filter cat --prune-empty --subdirectory-filter ABC HEAD
   

5. Then delete the backup reflogs so the space can be truly reclaimed (although now the operation is destructive)

   git reset --hard
   git for-each-ref --format="%(refname)" refs/original/ | xargs -n 1 git update-ref -d
   git reflog expire --expire=now --all
   git gc --aggressive --prune=now
   

   and now you have a local git repository of the ABC sub-directory with all its history preserved.

Paul的答案创建一个包含/ABC的新存储库，但不会从/XYZ中删除/ABC。下面的命令将从/XYZ中删除/ABC：

git filter-branch --tree-filter "rm -rf ABC" --prune-empty HEAD

当然，首先在一个 'clone --no-hardlinks' 的代码库中进行测试，然后执行Paul列出的重置、垃圾回收和修剪命令。

我发现为了正确地从新的代码库中删除旧的历史记录，您需要在 filter-branch 步骤之后再做一些工作。

1. 克隆并筛选：

   git clone --no-hardlinks foo bar; cd bar
   git filter-branch --subdirectory-filter subdir/you/want
   

2. 移除所有对旧历史的引用。“origin”用于跟踪克隆，而“original”则是filter-branch保存旧内容的地方：

git remote rm origin
git update-ref -d refs/original/refs/heads/master
git reflog expire --expire=now --all

3. 即使现在，您的历史记录可能被卡在一个packfile中，而fsck无法触及。将其撕成碎片，创建一个新的packfile并删除未使用的对象：

git repack -ad

这个问题在 filter-branch手册中有解释。

当使用更新版本的git（可能是2.22+）运行git filter-branch时，它会提示使用这个新工具git-filter-repo。这个工具确实为我简化了事情。

使用filter-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-to-rename，但我发现使用 --path-rename 选项可以获得稍微“更好”的历史记录。现在，在新仓库中移动文件的上次修改时间显示为 去年（在 GitHub UI 中），这与原始仓库中的修改时间相匹配。

而不是...

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

I ultimately ran...

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

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

• 由于我不知道使用 git 的扩展模式，安装时遇到了困难，但最终我克隆了 git-filter-repo 并将其符号链接到 $(git --exec-path)：

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

编辑：添加了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

现在这已经不那么复杂了，您可以在克隆的存储库上使用git filter-branch命令来删除您不想要的子目录，然后将更改推送到新的远程仓库。

git filter-branch --prune-empty --subdirectory-filter <YOUR_SUBDIR_TO_KEEP> master
git push <MY_NEW_REMOTE_URL> -f .

git-subtree可能对此很有用

http://github.com/apenwarr/git-subtree/blob/master/git-subtree.txt (已弃用)

http://psionides.jogger.pl/2010/02/04/sharing-code-between-projects-with-git-subtree/

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

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