Techyou labs
真正的爱应该超越生命的长度,心灵的宽度,灵魂的深度
常用标签
您正在查看:标签 subtree 下的文章

问题的产生

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

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

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

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

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

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 <子树名> <子仓库地址> <分支>

执行以上命令后,项目下就会新创建一个名为 <子树名> 的目录。
如果提前使用 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;