Git子模块

添加子模块

如果项目分的模块比较多,而且对每个模块需要独立管理的话,子模块就派上用场了。每一个子模块都是一个独立的git仓库,有点类似于svn的外链。下面简单讲一下在现有的git仓库里添加子模块的配置。

在主项目中添加子模块

git submodule add git@gitlab.code.anzogame.com:octopus/L1.git

这就完啦?对,就这么简单,回车后就会自动clone子模块的最新代码下来,并命名为L1,当然也可以重命名,只需要在命令后面跟上需要重命名的名字即可。

子模块的使用

clone带子模块的项目,前提是对子模块的仓库是有相应权限的

//方式一
git clone --recursive <url>

//方式二
git clone <url>
git submodule init
git submodule update

其实主项目只是保存了一个子模块的地址和对应的commit号,如下图:

git_submodule.png

注意这里只指向子模块仓库的某一个版本,一般情况下并不会特别指向某一个分支,clone代码的时候是把这个版本的代码clone下来了(不一定的子模块最新的代码)。如下图:

git_submodule_after_clone_state.png

不在分支上的本地工作区是不能提交同步代码的,所以这里如果后续需要对子模块修改提交并同步的话,是需要手动切换都某一个分支的,如下图:

git_submodule_checkout_branch.png

对子模块内容做修改后的提交

  • step1:当我们对子模块做了修改,比如我在L1子模块做了修改,此时查看状态:

git_submodule_modify_no_commit.png

注意看红色L1后面的状态,untracked content的意思是L1子模块里有内容修改,并且这个修改并没有被加入版本管理里。

  • step2:此时我对cd进入子模块里进行commit,主项目里的子模块的commit号就会随之改变,再看一下状态:

git_submodule_commit.png

此时L1后面跟的是new commits,这代表主项目所保存的子模块的版本号已经改变了,你需要将这个版本号在主项目也提交才行,不然就会出现不匹配的状态。

  • step3:这个时候就应该先cd进入子模块进行push,同步真正修改的内容到远程仓库,然后再回到主项目push,就是同步推送主项目指向子模块的commit号到远程仓库。

这里有个坑,大家刚开始的时候会经常遇到。甲同学对L1子模块进行了修改并且同步到远程仓库了,但是没有提交主项目对这个子模块的版本号,这时乙同学对子模块L1进行了单独的更新,这个时候问题就出现了,乙同学在主项目git status查看状态的时候会出现L1是红色的,并且是[new commits]状态,这是因为乙同学主项目里L1子模块的版本号已经变了,子模块的版本号只由当前子模块的最新commit号决定,也就是HEAD指针指向的commit号。所以这个时候需要请甲同学提交一下,如果不提交问题也不大,乙同学自己提交上去,只是这个时候甲同学再提交会出现L1的这commit号冲突,因为对于主项目来说这个子模块版本号两个人都做了修改,但是这个可以不解决,因为这个commit号是手动改不了了,也就是说不用解决这个冲突,保持最新就好。但是冲突总是大家不想遇到的,所以在对子模块有修改的时候尽量都把对应的主项目的版本号也提交上去,这才是最正确的操作。

多个子模块简便操作

当遇到一个功能需要多个子模块都同时做了修改,那么相应的对这几个子模块都要做一次提交,这个时候如果一个一个的cd进去再提交同步就会是个非常麻烦的事情,程序员都是懒得。这个时候用下面这个命令就可以完美解决:

git submodule foreach "<git command>"

他会对子模块一个一个的执行尖括号里的命令,例如git submodule foreach "git push"

讲完了!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,802评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,109评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,683评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,458评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,452评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,505评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,901评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,550评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,763评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,556评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,629评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,330评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,898评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,897评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,140评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,807评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,339评论 2 342

推荐阅读更多精彩内容