git subtree详解及使用场景

使用场景：

1.gitlab/github上已有两个项目，分别是project-web、project-mobile
2.现在需要将两个项目合并在一个项目里project
3.新项目project里包含两个文件，分别是web和mobile

---

操作步骤：

1.gitlab/github上新建项目project，获取project的git路径https://github.com/xxxxxx/project.git
2.在本地git clone https://github.com/xxxxxx/project.git
3.cd project + mkdir web
4.git remote add -f <新仓库名> https://github.com/xxxxx/project-web.git

‘-f意思是在添加远程仓库之后，立即执行fetch’

注意：这里可能会报错如下”Working tree has modifications. Cannot add”
报错原因：新建的project仓库里是空的
解决办法：在project远程仓库里随便添加个文件，git add + git commit + git push

5.执行git subtree add –prefix=<新仓库名> <目录名> <分支> –squash

如果省略–squash会将以前项目的提交历史记录合并为一条，为保留原来所有的历史记录，建议不加–squash

6.更新：git fetch <新仓库名> <分支>
7.更新：git subtree pull –prefix=<目录名> <新仓库名> <分支>
8.推送：git subtree push –prefix=<目录名> <新仓库名> <分支>
9.推送至远程仓库：git push origin <分支>
10.至此，project-web已经合并到project的web里了
11.mobile重复以上步骤即可。

---

最终仓库结构如下：

|-project
  |-web
  |-mobile