Git 子模块:git submodule
2018年03月08日阅读 2057
Git 子模块:git submodule
工作中,可能会遇到在一个Git仓库 中添加 其他 Git 仓库的场景。比如,在项目中引用第三方库。或者在模块化开发中,某些公共的模块是需要单独维护的,使用单独的仓库比较方便,但是在项目中需要引用,就会出现这样的场景。这里使用 Git 的 git submodule
命令为一个 git 项目
添加 子git项目
。
可以使用 git submodule --help
查看所有相关命令。 为了方便说明,这里在主项目 MainProject
中加两个子模块 liba
和 libb
.
1. 添加子模块
进入 MainProject
使用 git submodule add
进行添加,操作命令:
git clone https://github.com/imtianx/MainProject.git
cd MainProject/
git submodule add https://github.com/imtianx/liba.git
复制代码
如下图:
使用 git submodule add https://github.com/imtianx/libb.git
添加 libb
子模块。 对于上图,文件夹 liba
为新增加的子模块目录, .gitmodules
中存放的为子模块的信息,使用 cat
或 vim
查看内容为:
[submodule "liba"]
path = liba
url = https://github.com/imtianx/liba.git
[submodule "libb"]
path = libb
url = https://github.com/imtianx/libb.git
复制代码
.gitmodules文件:保存项目 URL 与已经拉取的本地目录之间的映射,有多个子模块则含有多条记录,会随着版本控制一起被拉去和推送的。
此时文件目录树如下:
.
├── README.md
├── liba
│ ├── README.md
│ ├── a.txt
│ └── a2.txt
├── libb
│ ├── README.md
│ ├── b.txt
│ └── b2.txt
└── test.text
复制代码
最后,提交添加的子模块到主目录
$ git commit -m "add liba and libb submodules"
[master 6b15e30] add liba and libb submodules
3 files changed, 8 insertions(+)
create mode 100644 .gitmodules
create mode 160000 liba
create mode 160000 libb
复制代码
2. 更新子模块
往往子模块是单独开发的,这里以更新 liba
为例(为了测试,这里先在liba仓库添加了一个文件):
cd liba/
git fetch
git merge origin/master
复制代码
操作结果如下图,注意需要进入子模块目录:
此外,还可以在主目录下 直接用下面的命令更新 libb
子模块:
git submodule update --remote liba
复制代码
使用下面的方式,更新 libb
的 dev
分支:
git config -f .gitmodules submodule.liba.branch dev
git submodule update --remote
复制代码
如下图:
这里对
.gitmodules
加了-f
参数,修改提交后对所有用户有效。
3. 删除子模块
在日常开发中,有添加,当然也会有删除 子模块的需求。 这里主项目包含两个子模块:liba
、libb
,以删除 liba
为例说明:
- 使用
git rm --cached liba
将liba 从版本控制中删除(本地仍保留有),若不需要可不带--cached
进行完全删除。 - 使用
vim .gitmodules
可打开vim编辑,删除对应的内容
[submodule "liba"]
path = liba
url = https://github.com/imtianx/liba.git
branch = dev
复制代码
- 使用
vim .git/config
可打开vim编辑,删除对应的内容
[submodule "liba"]
url = https://github.com/imtianx/liba.git
active = true
复制代码
- 使用
rm -rf .git/modules/liba
, 删除.git下的缓存模块,最后提交项目。
经过上面的删除后还可以进行添加子模块。
4. 克隆含子模块的仓库
若需要克隆含有子模块的仓库,直接 进行克隆是无法拉取之模块的代码,可加上 --recursive
参数,如下:
git clone --recursive https://github.com/imtianx/MainProject.git
复制代码
或者使用下面的三部操作:
git clone https://github.com/imtianx/MainProject.git
git submodule init
git submodule update
复制代码
更多子模块的操作,请参考官方文档:Git 工具 - 子模块
Git 子模块:git submodule的更多相关文章
- Git 子模块 - submodule
有种情况我们经常会遇到:某个工作中的项目需要包含并使用另一个项目. 也许是第三方库,或者你 独立开发的,用于多个父项目的库. 现在问题来了:你想要把它们当做两个独立的项目,同时又想在 一个项目中使用另 ...
- Git 子模块 - submodule(转)
原文地址: http://www.cnblogs.com/kelsen/p/5918672.html 有种情况我们经常会遇到:某个工作中的项目需要包含并使用另一个项目. 也许是第三方库,或者你 独立开 ...
- git子模块submodule
添加submodule: git submodule add 子模块git地址 把这个module放置的文件夹(这个文件夹须事先不存在) git submodule add http://xxx.x ...
- git 工具 - 子模块(submodule)
From: https://git-scm.com/book/zh/v2/Git-%E5%B7%A5%E5%85%B7-%E5%AD%90%E6%A8%A1%E5%9D%97 子模块 有种情况我们经常 ...
- git submodule git 子模块管理相关操作
Git 子模块操作相关的一些命令备忘: # 当使用git clone下来的工程中带有submodule时,初始的时候 submodule的内容并不会自动下载下来的,需执行如下命令: git submo ...
- Git子模块引用外部项目
Git子模块(submodule)简介 经常有这样的事情,当你在一个项目上工作时,你需要在其中使用另外一个项目.也许它是一个第三方开发的库或者是你独立开发和并在多个父项目中使用的.这个场景下一个常见的 ...
- jenkin+Git子模块自动拉取代码
jenkins+Git子模块自动拉取代码 添加Git子模块 先克隆想要添加子模块的仓库git clone ssh://git@ip:port/user/project.git,这个是主目录. 进入仓库 ...
- 手把手教你把 Git 子模块更新到主项目
本文以 skywalking-rocketbot-ui子模块合并到 skywalking 为例,手把手教你如何把 Git 子模块更新到主项目中去. 首先,把fork的skywalking项目克隆到本地 ...
- git子模块的使用
1. 在项目中添加子模块 命令: git submodule add <url> 例子: git submodule add https://github.com/chaconinc/Db ...
随机推荐
- Resource interpreted as Stylesheet but transferred with MIME type text/plain
今天碰到了Resource interpreted as Stylesheet but transferred with MIME type text/plain 这个错误. 原因:在web中配置了f ...
- react.js map遍历的问题
React遍历多个Ant Design中的Upload组件时,随意删除任一个Upload出现了bug,依次点击上传图片后,当点击删除时,倒着删除没有问题,从中间和从开头删问题出现了,出现了类似塌方的效 ...
- HttpPost请求将json作为请求体传入的简单处理方法
https://www.cnblogs.com/mambahyw/p/7875142.html **************************************************** ...
- Kaggle 自行车租赁预测比赛项目实现
作者:大树 更新时间:01.20 email:59888745@qq.com 数据处理,机器学习 回主目录:2017 年学习记录和总结 .caret, .dropup > .btn > . ...
- Ubuntu 中的VI和vim
转载出处:http://blog.csdn.net/xiajun07061225/article/details/7039413 或功能键[Home]:移动到这一行的最前面字符处. $或功能键[End ...
- 第三百九十六节,Django+Xadmin打造上线标准的在线教育平台—其他插件使用说,自定义列表页上传插件
第三百九十六节,Django+Xadmin打造上线标准的在线教育平台—其他插件使用说,自定义列表页上传插件 设置后台列表页面字段统计 在当前APP里的adminx.py文件里的数据表管理器里设置 ag ...
- Spark学习笔记——文本处理技术
1.建立TF-IDF模型 import org.apache.spark.{SparkConf, SparkContext} import org.apache.spark.mllib.linalg. ...
- @Autowired注入为null问题分析
题说明 最近看到Spring事务,在学习过程中遇到一个很苦恼问题 搭建好Spring的启动环境后出现了一点小问题 在启动时候却出现[java.lang.NullPointerException] 不过 ...
- ASP.NET MVC 4 (十二) Web API
Web API属于ASP.NET核心平台的一部分,它利用MVC框架的底层功能方便我们快速的开发部署WEB服务.我们可以在常规MVC应用通过添加API控制器来创建web api服务,普通MVC应用程序控 ...
- linux log
adb shell logcat GOODIX:v *:s cat /proc/kmsg | grep "<<" ./cbootimg.sh adb shell get ...