本章主要测试讲解
- 如何将一个 git 管理的较大的项目按文件夹拆分成几个小项目，且各个小项目只保留自己文件夹中的文件的历史记录。
- 两种方式实现
- 使用
git filter-branch的实现 - 使用
git subtree的实现(推荐)
- 使用
本篇内容，不建议跳过，如果有这个需求，还请仔细详细查看，谢谢。
测试过程
前置说明
与项目合并相反，这是需要把单一项目的.git 的提交记录，抽取出各自子项目想要的部分。不过，相对于合并，拆分要简单些。
就不考虑把一个单独的文件拆成一个项目了。如果实在需要，就把这个单个文件，也放到一个文件夹中，再拆这个文件夹即可。
本地 git 仓库使用的是相对路径，所以直接修改 root folder 不会影响 git 历史记录
项目准备
不将上一篇合并好的 timetools 再拆开。直接使用之前从 github 上克隆的 dayjs 项目作业。
在作业前，dayjs 的结构是这样的：
查看一下，此时所有的日志 log 修改的文件名。如下图（这里是可以看到所有文件修改内容和提交数量）：
dayjs 项目中，dayjs/src/有两个文件夹，locale/和 plugin/，示例假装 locale/需要拆出来，做一个单独的项目。
大概流程
-
1 使用
git filter-branch- 重写提交历史记录
- 清除.git 的 object 文件夹(如果觉得有必要的话)
- 查看日志信息
-
2 使用
git subtree- 进入 dayjs，创建一个临时分支
- 创建一个新的 git 空项目
- 将原仓库的临时分支 my-locale 拉到新仓库
使用git filter-branch实现–不推荐,仅作了解,不感兴趣可略过
重写提交历史记录
$ git filter-branch --tag-name-filter cat --prune-empty --subdirectory-filter src/locale -- --all
命令说明：
git filter-branch通过重写分支来重写 Git 修订历史记录，并在每个修订版上应用自定义过滤器。
- –tag-name-filter <command> 该参数控制我们要如何处理旧的 tag，cat 即表示原样输出；
- –prune-empty 删除空的（对子目录没有影响的）提交；
- –subdirectory-filter <directory> 指定子目录路径；
- – –all
-- all参数必须跟在 – 后面，表示对所有分支进行操作。如果你只想保存当前分支，也可以不添加此参数。
此操作会花点时间，执行完成，可以看到，原版的 dayjs 下的文件，变成了这样：
清除.git 的 object 文件夹(如果觉得有必要的话)
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
git for-each-ref 根据给定的集合对它们进行排序之后，迭代所有匹配的 ref <pattern>并根据给定的显示它们。
- –format=<format> %(fieldname)从所显示的 ref 及其指向的对象插入的字符串。
git-update-ref-安全地更新存储在 ref 中的对象名称
- 带-d 标志，它在验证命名的<ref>仍然包含<oldvalue>后将其删除
git reflog expire 修剪较旧的引用日志条目。
- –expire=<time> 修剪早于指定时间的条目。
- –all 处理所有引用的引用日志。
git-gc 清理不必要的文件并优化本地存储库
- –aggressive 此选项将导致 git gc 更积极地优化存储库，但花费更多时间。
- –prune=<date> 修剪比日期更旧的松散对象（默认为 2 周前)
清除的执行如下图：
查看日志信息
其实最重要就只有第一步而已，完成之后，现在可以查看到现在的 dayjs 的日志
如下图：
现在只有原来在 dayjs/src/locale 里面的文件被修改的提交记录被保留，其它的都丢掉了。
只要把这个现在的 dayjs 修改成 locale，就完成了大项目拆分成子项目的操作。
使用git subtree实现–推荐做法
同样，使用最开始的从 github 中拉下来的 dayjs 做源项目。
进入 dayjs，创建一个临时分支
git subtree split -P src/locale -b my-locale
命令说明：
git subtree 合并子树并将存储库拆分为子树。
这个命令不在原本的 git 参考文件上，不过用法比较简单，可以在这里查看的更多用法。
- split
从<prefix>子树的历史中提取一个新的合成项目历史。新的历史记录仅包括影响<prefix>的提交（包括合并），并且这些提交中的每个现在都在项目的根目录而不是子目录中具有<prefix>的内容。因此，新创建的历史记录适合作为单独的 git 存储库导出。 - -P <prefix> = –prefix=<prefix> 在存储库中指定的子树的路径
- -b <branch> 创建一个分支
如下图
创建一个新的 git 空项目
在与 dayjs 平级的路径下，创建一个文件夹，例如 my-locale(和上一步创建的分支名没任何关系)，并进入，然后 git 初始化
cd ..
mkdir my-locale
cd my-locale
git init
如下图：
将原仓库的临时分支 my-locale 拉到新仓库
git pull ../dayjs my-locale
如下图
查看日志，效果一致，如下图：
对于一开始说的，单个文件，想要这样做，似乎不行。如下图。
还是放到文件夹吧。
总结
- 使用
git filter-branch拆分子项目，是会把除了需要被拆分的部分，全部都删除了，包括.git 仓库里的东西。这是在原本的项目上进行作业。 - 使用
git subtree是在原项目中创建了临时分支，再拉取到新的 git 空项目，不会对原项目进行异动，原项目甚至不会知道子项目的存在。 - 如果提交的次数较多，为了筛选所有的历史记录，都会比较耗时间。但不修改原项目的
git subtree，显然更好。 - git subtree 创建子项目命令小计
cd <source-project>
git subtree split -P <prefix> -b <temp-branch>
cd ..
mkdir <sub-project>
cd <sub-project>
git init
git pull <source-project path> <temp-branch>
