git subtree使用体验

骑猪看日落 2022-12-28 06:59 149阅读 0赞

--------------------

git subtree

--------------------

> 旧版本的git也支持(最老版本可以到 v1.5.2).

详细了解先看这篇文章，写的挺好：[https://tech.youzan.com/git-subtree/][https_tech.youzan.com_git-subtree]

下面介绍具体操作：

1、初始化subtree项目

在主项目根目录的下面

> git subtree add --prefix=用来放S项目的相对路径 S项目git地址 xxx分支

例如：git subtree add --prefix=modules/MultiMedia/TVKPlayer\_Android/ [http://git.code.oa.com/XXX\_Android.git][http_git.code.oa.com_XXX_Android.git] tvideo/765

例如：git subtree add --prefix=modules/MultiMedia/ThumbPlayer/ [http://git.code.oa.com/XXX\_Android.git][http_git.code.oa.com_XXX_Android.git 1] tvideo/765 \--squash

问题1：如果subtree中有lfs的话，会add失败

解决方法： 先执行git lfs install --skip-smudge，再add

解释：

–prefix之后的=等号也可以用空格

问题：永远也解不完的冲突

–squash意思是把subtree的改动合并成一次commit，这样就不用拉取子项目完整的历史记录。

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

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

2、pull代码到父项目：

> git subtree pull --prefix=S项目的路径 S项目git地址 xxx分支

例如：git subtree pull --prefix=modules/MultiMedia/TVKPlayer\_Android/ [http://git.code.oa.com/XXX\_Android.git][http_git.code.oa.com_XXX_Android.git] tvideo/765

例如：git subtree pull --prefix=modules/MultiMedia/ThumbPlayer/ [http://git.code.oa.com/XXX\_Android.git][http_git.code.oa.com_XXX_Android.git 1] tvideo/765 --squash

3、push代码到subtree的仓库

在主项目的根目录下面：

> git subtree push --prefix=S项目的路径 S项目git地址 xxx分支

例如： git subtree push --prefix=modules/MultiMedia/TVKPlayer\_Android/ [http://git.code.oa.com/XXX\_Android.git][http_git.code.oa.com_XXX_Android.git] tvideo/765

例如： git subtree push --prefix=modules/MultiMedia/ThumbPlayer/ [http://git.code.oa.com/XXX\_Android.git][http_git.code.oa.com_XXX_Android.git 1] tvideo/765

git subtree merge --prefix=

给子仓库取一个好记的名字，为了后面使用方便

语法：git remote add -f

解释：其中-f意思是在添加远程仓库之后，立即执行fetch。

问题2：当主项目的 commit 提交太多后，再推送子项目到远程库的时候，subtree 每次都要遍历很多 commit，浪费的时间相当多，很是不爽。

解决方法：split打点，作为下次遍历的起点。

git subtree split --rejoin --prefix= --branch

例如：git subtree split --rejoin --prefix=themes/icarus --branch icarus

这个分支只是作起点储存用的，不用管它不用修改不用推送到远程库。下次使用相同的命令更新这个起点就可以了。

git subtree split --rejoin --prefix=modules/MultiMedia/ThumbPlayer/ --branch icarus

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5neGlhb21pbmdsaXBlbmc_size_16_color_FFFFFF_t_70][]

git 列出所有的 subtree

git subtree pull fatal refusing to merge unrelated histories问题

1. 用 git subtree add 是對的！

2. 記得下完 git subtree add 後，一定要多下一個下面的指令！

記得下完 git subtree add 後，一定要多下一個下面的指令！

因為很重要所以說三次

git merge -s ours --no-commit --allow-unrelated-histories shareLibraryRepo/master

這行指令就是建立好 subtree 關係的關鍵步驟啊！！！（抱頭）就差了這一個步驟，所以讓我一開始會遇到 refusing to merge unrelated histories 的錯誤訊息

git merge -s ours --no-commit --allow-unrelated-histories [http://git.code.oa.com/XXX\_Android.git][http_git.code.oa.com_XXX_Android.git 1] tvideo/765

git merge -s ours --no-commit --allow-unrelated-histories [http://git.code.oa.com/XXX\_Android.git][http_git.code.oa.com_XXX_Android.git] tvideo/765\_test

git merge -s ours --no-commit --allow-unrelated-histories [http://git.code.oa.com/XXX\_Android.git][http_git.code.oa.com_XXX_Android.git 1] tvideo/765\_test

注：我在使用的时候好像没有使用这个命令

> 总体来说，git subTree 不是很好用，，首先是有上面提交的2个问题，体验上就不太好了。
> 
> 如果不设计代码的双向同步，，可以考虑使用maven包方式

[https_tech.youzan.com_git-subtree]: https://tech.youzan.com/git-subtree/
[http_git.code.oa.com_XXX_Android.git]: http://git.code.oa.com/TencentVideoMultiMedia/TVKPlayer_Android.git
[http_git.code.oa.com_XXX_Android.git 1]: http://git.code.oa.com/TencentVideoMultiMedia/ThumbPlayer_Android.git
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5neGlhb21pbmdsaXBlbmc_size_16_color_FFFFFF_t_70]: /images/20221120/779e36ee2e754abb896b9f0f546c2d15.png