组件化之仓库迁移

组件化的其中一个常见场景，是在一个已经本地组件化（至少已经按文件夹划分）的大仓库里，将其中一个本地组件改为远程组件独立仓库，便于组件复用、版本管理、权限管理等。

这里有个问题，远程组件独立的Git仓库，能否保留原来的所有历史记录？

答案是可以的，使用git subtree split命令。以下按不同情况说明。

从已存在的仓库A拆分一个文件夹到新的仓库中

现在有一个仓库A，如下


.
├── Components
│   ├── Login
│   │   ├── Login.h
│   │   ├── Login.m
│   ├── Pay
│   │   ├── Pay.h
│   │   └── Pay.m
│   └── User
└── Host

准备将其中的Components/Login和Components/Pay拆分到不同的新的独立仓库，效果如下

A仓库


.
├── Components
│   └── User
└── Host

Login仓库


.
├── Login.h
├── Login.m

Pay仓库


.
├── Pay.h
└── Pay.m

则步骤如下

在A仓库所在目录，运行以下命令。在A仓库的当前分支，遍历所有历史提交，将其中包含路径前缀为Components/Login的文件的提交合并放到名为temp_branch_login（名字无所谓）的临时分支中。注意，由于是遍历，如果A仓库提交数量比较多的话，需要运行较长时间。


git subtree split --prefix Components/Login -b temp_branch_login

2. 等待过程中可以打开你的Git网站创建一个空白的远程仓库，注意不要勾选以下任意选项。

Github

Gitlab

3. 在A仓库外的另一个位置，运行以下命令。初始化新的仓库，并将刚刚的临时分支提交复制过来。


mkdir Login
cd Login
git init
git pull A仓库所在路径 temp_branch_login


git remote add origin https://github.com/xxx/xxx.git
git push --set-upstream origin master

这时已经完成了。Login仓库的效果如上述所示。Pay仓库可如法炮制。

💡

如果上面的例子里不小心勾选了Initialize repository的选项，就可参考这部分内容。

先使用上述的git subtree split命令，然后在B仓库所在目录里，运行以下命令


git pull A仓库所在路径 temp_branch_login

如果报错fatal: refusing to merge unrelated histories，则改为运行以下命令


git pull A仓库所在路径 temp_branch_login --allow-unrelated-histories

会产生一个merge，提交即可。完成。

这种情况其实是最简单的，在C仓库所在目录中，运行以下命令


git pull B仓库所在路径 B仓库的某个分支 --allow-unrelated-histories

或者直接


git pull B仓库的Git地址 B仓库的某个分支 --allow-unrelated-histories