如何将现有 git 仓库中的子项目单独抽出来作为一个独立仓库并保留其提交历史
如何将现有 git 仓库中的子项目单独抽出来作为一个独立仓库并保留其提交历史
2018-09-03 15:53 by 猴子猿, … 阅读, … 评论, 收藏, 编辑
很多时候,我们会遇到在一个git仓库下包含了很多小项目,但是随着有些项目的需求逐渐增大或则市场需求,我们需要将其抽离出来,作为一个单独的项目进行维护并开发。
但是,如果直接拷贝文件粘贴到新建的git repository中,会丢掉原有的commit,所以我们不能这么粗暴地做。
怎么办呢?下面会根据一个例子,详细说明。
假如我们在demos仓库中,包含了如下小项目,其中,我们想将Comet这个目录下的文件单独抽出来,作为一个单独的项目维护开发,如下:
首先,我们通过git clone 将demos导入到本地,然后通过git remote rm origin,切断与远程仓库的关联,如下:
然后,运行git filter-branch –tag-name-filter cat –prune-empty –subdirectory-filter <name-of-folder>命令,过滤掉并保留对指定子目录的commit,并将该子目录设为该仓库的根目录:
1. –tag-name-filter:控制我们如何处理旧tag,cat表示原样输出
2. –prune-empty:删除空提交,即对子目录没有影响的
3. –subdirectory-filter:指定子目录路径
运行该命令后,我们可以看见我们的原仓库变为了这样:
虽然从表面上看,我们到达了我们的目的,新仓库已变成了子目录的内容,并且也保留了相关commit,但是新仓库的.git目录并没有被reset,所以我们还需运行如下命令,去为.git瘦身,如下:
好了,到目前为止,子项目提取工作完成。
最后,就是将本地的这个子项目push到远程仓库中了。因为在此之前,我们已经断了原有的远程仓库链接,所以此时我们需要将这个子项目链接到新的远程仓库中。
假设,我们新建一个远程仓库名为testRepo,如下:
按照提示,我们通过git remote add命令,将子项目与该远程仓库链接并push,如下:
这样就完成了我们的目的,下面是远程仓库testRepo结果: