【Git】拆仓(原Git库拆分子目录作为新仓库,并保留log记录)

一.需求描述:
现有一个git仓库,Team A和Team B的人操作同一仓库的不同目录,Team A的dev希望Team B的dev没有权限review属于Team A的代码目录,故现需要先将这个git 库下的子目录进行拆分,为后续单git库权限独有覆盖做准备.
二.操作背景:
Ubuntu shell(终端)
三.迁移(使用filter-branch命令)
由于我需要迁移的子目录包含中文名，因此需要使用filter-branch命令来实现迁移，当然，如果不包含中文的目录也可以使用git1.8版本以后的subtree来实现，该方法稍后说明。

1. 首先，clone 一份原仓库并删掉原来的 remote：（依次执行以下命令）
   （1）git clone ssh://username@xx.x.xx.xxx:29418/vendor/lenovo
   （2）cd lenovo
   （3）git remote rm origin
2. 然后运行如下命令（这是重点）：
   （1）git filter-branch --tag-name-filter cat --prune-empty --subdirectory-filter -- --all
   这条命令同样会过滤所有历史提交，只保留所有对指定子目录有影响的提交，并将该子目录设为该仓库的根目录。这里说明各下个参数的作用：
   --tag-name-filter 该参数控制我们要如何处理旧的 tag，cat 即表示原样输出；
   --prune-empty 删除空的（对子目录没有影响的）提交；
   --subdirectory-filter 指定子目录路径；
   -- --all 该参数必须跟在  -- 后面，表示对所有分支进行操作。如果你只想保存当前分支，也可以不添加此参数。
3. 清理.git的object
   当上述命令执行完毕后，就可以看到本地的新仓库已经是原仓库子目录中的内容了，且保留了关于该子目录所有的提交历史。不过只是这样的话新仓库中的
   .git 目录里还是保存有不少无用的 object，我们需要将其清除掉以减小新仓库的体积（如果你用subtree 的方法的话是不需要执行这一步的）。
   依次执行以下命令：
   （1）git reset --hard
   （2）git for-each-ref --format="%(refname)" refs/original/ |xargs -n 1 git update-ref -d
   （3）git reflog expire --expire=now --all
   （4）git gc --aggressive --prune=now
   温馨提示:git gc操作耗时比较久,请耐心等待.
4. 将新的本地仓库推送到远端
   cd到
   （1）添加远端地址:
   git remote add origin
   （2）推送到远端：
   git push -u origin master或者git push --fore origin master

四.subtree方式拆仓
用法： git subtree split -P [name-of-folder] -b [name-of-new-branch]
说明： subtree是把一个分支拆分到另一个分支，这样的话操作起来更方便，不会改写原来分支的内容

举例：
最典型的就是Qualcomm下的AMSS部分和vendor/qcom/proprietary部分了。
例如（包括拆仓后的push）：

git subtree split -q -P LA.UM.9.14/LINUX/android/vendor/qcom/proprietary -b proprietary_master
git push -f ssh://gerrit.xxx.com:29418/git/android/platform/vendor/qcom/proprietary proprietary_master:sm8350_r_r1.0.c7_00001.9.377585.0_rebase_20210224

git subtree split -q -P Lahaina.LA.1.0/common -b common_master
git push -f ssh://gerrit.xxx.com:29418/git/android/AMSS/common common_master:sm8350_r_r1.0.c7_00001.9.377585.0_rebase_20210224

参考链接:
https://blog.csdn.net/wang252949/article/details/80003791
https://blessing.studio/splitting-a-subfolder-out-into-a-new-git-repository/