使用Git Submodule可能遇到的坑


2013-05-13 10:03 cocoachina cocoachina  字号: T |  T
一键收藏,随时查看,分享好友!

随着近几年的发展,Git已经成为开源界的标准的版本控制工具。开源界的重量级项目,如Linux, Android, Eclipse, Gnome, KDE, Qt, ROR, Debian,无一例外的都是使用git来进行版本控制。在使用的过程中,作者发现了一些问题,在此分享给大家。



转载自:http://mobile.51cto.com/aprogram-393324.htm



前言

对于一些比较大的工程,为了便于复用,常常需要抽取子项目。例如我开发的猿题库客户端现在包括3门考试,客户端涉及的公共UI、公共底层逻辑、公共的第三方库、以及公共的答题卡扫描算法就被我分别抽取成了子项目。这些子项目都以git submodule的形式,增加到工程中。

在使用了git submodule一段时间后,我发现了一些submodule的问题,在此分享给大家。
更新submodule的坑

submodule项目和它的父项目本质上是2个独立的git仓库。只是父项目存储了它依赖的submodule项目的版本号信息而已。如果你的同事更新了submodule,然后更新了父项目中依赖的版本号。你需要在git pull之后,调用 git submodule update来更新submodule信息。

 

这儿的坑在于,如果你git pull之后,忘记了调用 git submodule update,那么你极有可能再次把旧的submodule依赖信息提交上去。对于那些习惯使用 git commit -a的人来说,这种危险会更大一些。所以建议大家:
1.git pull之后,立即执行git status, 如果发现submodule有修改,立即执行git submodule update
2.尽量不要使用 git commit -a, git add命令存在的意义就是让你对加入暂存区的文件做二次确认,而 git commit -a相当于跳过了这个确认过程。

 

更复杂一些,如果你的submodule又依赖了submodule,那么很可能你需要在git pull 和 git submodule update之后,再分别到每个submodule中再执行一次git submodule update,这里可以使用 git submodule foreach命令来实现: git submodule foreach git submodule update

 

修改submodule的坑

有些时候你需要对submodule做一些修改,很常见的做法就是切到submodule的目录,然后做修改,然后commit和push。

 

这里的坑在于,默认git submodule update并不会将submodule切到任何branch,所以,默认下submodule的HEAD是处于游离状态的(‘detached HEAD’ state)。所以在修改前,记得一定要用git checkout master将当前的submodule分支切换到master,然后才能做修改和提交。

 

如果你不慎忘记切换到master分支,又做了提交,可以用cherry-pick命令挽救。具体做法如下:
1.用 git checkout master 将HEAD从游离状态切换到 master 分支, 这时候,git会报Warning说有一个提交没有在branch上,记住这个提交的change-id(假如change-id为 aaaa)
2.用 git cherry-pick aaaa 来将刚刚的提交作用在master分支上
3.用 git push 将更新提交到远程版本库中

 

以下是相关命令的操作示范和命令行输出结果:
1. ui_common git:(df697f9) git checkout master
2.Warning: you are leaving 1 commit behind, not connected to
3.any of your branches:
4.
5.  df697f9 forget to check out master
6.
7.If you want to keep them by creating a new branch, this may be a good time
8.to do so with:
9.
10. git branch new_branch_name df697f911e5a0f09d883f8f360977e470c53d81e
11.
12.Switched to branch 'master'
13. ui_common git:(master) git cherry-pick df697f9

 

使用第三方工具

对于submodule的重度使用者,有几个工具可作推荐:
1.Repo Google用于管理Android项目的工具。
2.Gitslave
3.Git Subtree

以上工具,我都没有实际用过,所以无法提供更多信息。

 

Tips

由于常常使用submodule的相关命令,可以在 ~/.gitconfig文件中将其设置别名,方便操作,我设置的所有相关别名如下:
1.[alias]
2.  st = status -s
3.  ci = commit
4.  l = log --oneline --decorate -12 --color
5.  ll = log --oneline --decorate --color
6.  lc = log --graph --color
7.  co = checkout
8.  br = branch
9.  rb = rebase
10.  dci = dcommit
11.  sbi = submodule init
12.  sbu = submodule update
13.  sbp = submodule foreach git pull
14.  sbc = submodule foreach git co master


参考链接
1.《why-your-company-shouldnt-use-git-submodules》 (需翻墙)

2.《Git_submodule_tutorial》
 

来源:唐巧的技术博客

Git SubmoduleGit 提供的一种嵌套式仓库的方式,可以将其他 Git 仓库作为子模块嵌入到主仓库中,并在需要的时候更新子模块的代码,实现主仓库和子模块的分离管理。 以下是一个使用 Git Submodule 的完整示例: 1. 创建主仓库 首先,创建一个新的 Git 仓库作为主仓库,并将其初始化: ``` mkdir main_repo cd main_repo git init ``` 2. 添加子模块 接下来,我们需要将一个已有的 Git 仓库作为子模块添加到主仓库中。假设我们要添加的子模块仓库地址为 https://github.com/user/submodule_repo.git,执行以下命令: ``` git submodule add https://github.com/user/submodule_repo.git ``` 此时,Git 会将子模块仓库克隆到主仓库中,并将其作为一个子模块添加到主仓库的 .gitmodules 文件中。可以使用以下命令查看子模块信息: ``` git submodule status ``` 3. 更新子模块 当子模块仓库发生变化时,我们需要更新主仓库中的子模块代码。可以使用以下命令: ``` git submodule update --remote ``` 这会将子模块仓库最新的代码更新到主仓库中。如果在更新过程中遇到冲突,需要手动解决冲突后再提交。 4. 提交代码 最后,我们需要将主仓库和子模块的代码一起提交到 Git 仓库中。可以执行以下命令: ``` git add . git commit -m "Add submodule and update code" git push ``` 这样,主仓库和子模块的代码都会被推送到 Git 仓库中,并且可以在其他机器上克隆主仓库时自动初始化和更新子模块。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值