October 8, 2017

问题的产生

subtree 处理多层包含是没有问题的，因为包含进项目之后，别人根本看不出这是一个 subtree，所以它本质上还只是管理本地 repo 的一种方法。

使用 Git subtree 新建或更新子项目的时候，可以选用 --squash 参数，它的作用就是把 subtree 子项目的更新记录进行合并，再合并到主项目中。

所以，在使用 --squash 参数的情况下， subtree add 或者 pull 操作的结果对应两个 commit，一个是 Squash 了子项目的历史记录，一个是 Merge 到主项目中。

这种做法下，主项目的历史记录看起来还是比较整齐的。但在子项目有更新，需要 subtree pull 的时候，却经常需要处理冲突。严重的，在每次 subtree pull 的时候都需要重复处理同样的冲突，非常烦人。

如果不使用 --squash 参数，子项目更新的时候，subtree pull 很顺利，能够自动处理已解决过的冲突，缺点就是子项目的更新记录“污染”了主项目的。

继续阅读

git subtree使用场景

September 21, 2017

假设你有一个在线商城项目 Shop，这个项目下有个订单模块 order，这个 order 模块很通用，你在下一个团购系统 Groupon，也要用到这个 order 模块，最简单的方式就是把整个 order 模块 copy 过来。

然而，这种 copy 方式，会很难维护：order 模块修改了一个Bug，然后又要复制更新到所有用了 order 模块的项目里。

这时就需要 git subtree 来管理这个 order 模块了：把 order 模块单独作为一个 git 仓库，在需要用到 order 模块的项目，通过使用 git subtree 把 order 模块当作一个 git 项目来引入，这就解决了 order 模块的共享和维护问题。
git subtree --help 可以查看 git subtree 命令的帮助文档。

git subtree 命令中，都会用到一个参数 --prefix=，可以简写成 -P ，本文的命令都是这样使用的。

git subtree add 添加项目作为子树


git subtree add -P &lt;子树名&gt; &lt;子仓库地址&gt; &lt;分支&gt;

执行以上命令后，项目下就会新创建一个名为 <子树名> 的目录。
如果提前使用 git remote add <子仓库名> <子仓库地址> 添加了子项目的远程仓库地址（建议按此方式，下文都基于此），那么也可以这样：


git subtree add -P &lt;子树名&gt; &lt;子仓库名&gt; &lt;分支&gt;

以上命令可以多加一个 --squash 参数：


git subtree add -P &lt;子树名&gt; &lt;子仓库名&gt; &lt;分支&gt; --squash

--squash 参数含义是：把 subtree 的改动合并成一次commit，这样就不用写入子项目完整的历史记录。

git subtree pull 从子仓库拉取子树更新

先 fetch：


git fetch &lt;子仓库名&gt; &lt;分支&gt;

后 pull：


git subtree pull -P &lt;子树名&gt; &lt;子仓库名&gt; &lt;分支&gt;

以上命令也可以多加一个 --squash 参数：


git subtree pull -P &lt;子树名&gt; &lt;子仓库名&gt; &lt;分支&gt; --squash

git subtree push 推送子树更新到子仓库


git subtree push -P &lt;子树名&gt; &lt;子仓库名&gt; &lt;分支&gt;

继续阅读