Git 子模块submodule的使用

最新推荐文章于 2025-09-04 08:46:25 发布
最新推荐文章于 2025-09-04 08:46:25 发布
阅读量1.4k 收藏 3
点赞数
CC 4.0 BY-SA版权
分类专栏： 开发环境 开发工具 文章标签： git git submodule submodule 子模块
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/h4x0r_007/article/details/108167592
Git子模块(submodule)允许在一个项目中包含另一个独立的git仓库。使用时需注意，子模块提交push后，主模块需同步更新其记录的子模块hash值，否则可能导致冲突。本文详细介绍了如何添加子模块、更新子模块以及如何处理子模块代码修改的流程。

文章目录


参考资料

Git submodule

git submodule用于：一个git仓库中，包含另一个git仓库，两个仓库的提交记录，需同时保持独立存在。
当主项目中引入第三方git仓库，作为子项目的submodule可以修改、更新代码。
坑点：
submodule commit push后，由于主module记录了子项目的hash值，需要同时push 主module sha值，否则更新主module后会产生冲突：无法更新、无法回滚、无法合并。参考Git submodule的坑

以下MainModule、SubModule分别表示主module git、子module git实际地址。
主项目：https://MainModule.git
子项目：https://SubModule.git<

最低0.47元/天 解锁文章
git submodule update 游离分支 临时分支问题记录 解决办法
qq_38292379的博客
05-24 1563
git submodule update --init git pull origin master --recuresive-submodule 拉取子模块代码，子模块显示在临时分支上 $ git branch * (HEAD detached at da3251f) branch01 master 可以理解为submodule update拉取代码使用了checkout命令，而不关注具体是什么分支 git checkout xxx 因此在拉取子模块代码后，如果要进行开发，记得执行 $
Git - submodule 小记
幻世
03-11 2030
一些对 submodule 疑惑的整理
git submodule 使用教程
卓学课堂
03-21 5690
（1）项目很大参与开发人员多的时候，需要将各个模块文件进行抽离单独管理。（2）使用git submodule来对项目文件做成模块抽离，抽离出来的文件可单独成为一个git仓库。整个主项目对抽离出来的子项目（子模块）有依赖关系，却又并不关心子项目（子模块）的内部开发流程细节；（3）代码如果全员可见，可以做成分支进行管理；如果代码不可见，可以创建为子仓库（独立一个git 仓库）；子仓库管理模块代码，主仓库定时更新（4）简单理解：项目工程为一个仓库；模块为一个仓库；
关于git submodule的使用以及注意事项
weixin_46708094的博客
10-22 1096
submodule项目和它的父项目本质上是2个独立的git仓库。只是父项目存储了它依赖的submodule项目的版本号信息而已。如果你的同事更新了submodule，然后更新了父项目中依赖的版本号。你需要在git pull之后，调用 git submodule update来更新submodule信息。 这儿的坑在于，如果你git pull之后，忘记了调用 git submodule update，那么你极有可能再次把旧的submodule依赖信息提交上去。对于那些习惯使用 git commit -a的人来
【微知】git submodule的一些用法总结(不断更新）
最新发布
技术札记
09-04 1183
Git子模块操作要点 新增子模块方法： 手动修改.gitmodules后执行git submodule init 使用git submodule add命令自动配置 关键操作： git submodule init：根据.gitmodules初始化配置 git submodule sync：同步配置到.git/config git submodule update：更新子模块内容 注意事项： 修改.gitmodules后必须执行sync才能使配置生效 update命令会根据.git/config配置拉取代码
git sub module使用注意
weixin_30260399的博客
07-01 376
如果clone的时候忘记改名了 要改三个地方 本来的文件夹名字 .gitmodules中的名字 .git/modules/.....名字 .git/config # 看样子还是不够，还是改回来吧！用默认的！ https://git-scm.com/book/zh/v2/Git-%E5%B7%A5%E5%85%B7-%E5%AD%90%E6%A8%A1%E5%9D%97 ...
Nginx模块——sub_module
qq_37117521的博客
06-19 372
服务端给客户端response HTTP内容的时候，用于对HTTP的内容进行替换 应用场景：Nginx作为HTTPserver有多个输出用机，需要对每一个虚拟主机返回的http内容进行内容替换。 配置语法（sub_filter用得最多）： String:要替换的内容 Replacement:替换以后的内容 服务端和客户端每次请求的时候，校验服务端的内容有没发生更新。如果有更新...
git中submodule子模块的添加、使用和删除的示例代码
10-14
Git子模块是Git仓库管理中的一个高级特性，它允许你在主项目中嵌入其他Git仓库作为子项目。这种做法在大型项目中非常常见，因为它们可能依赖于其他独立维护的库或组件。通过使用子模块，你可以保持这些依赖的版本...
Git子模块（Submodule）详解：前端项目管理的高效实践
2401_87546826的博客
02-14 796
Git子模块允许你将一个Git仓库作为另一个Git仓库的子目录。它能让你保持父子项目的独立版本控制，同时建立明确的依赖关系。Git子模块为前端项目的模块化管理提供了灵活方案，特别适合以下场景： ✅ 需要严格控制依赖版本 ✅ 跨项目共享私有组件库 ✅ 维护多项目间的关联关系建议搭配可视化工具（如SourceTree、GitKraken）使用，可以更直观地管理子模块状态。扩展学习Git官方Submodule文档进阶技巧：使用Git Hook自动化子模块更新。
git 嵌套使用：Submodule
zhjmyx的专栏
08-27 1892
git 嵌套使用：Submodule 一、概述 诉求：希望把一个lib做成maven 的效果，各个工程都可以依赖，实现复用。 但是maven 独立项目的特点决定了他的开发成本和维护成本都比较高。 方案一：lib 随工程走，阶段性的用 beyond compare 这类比较器同步，通过手动的方式阶段性的维护一个 复用库。 优点: 首次操作简单 缺点：不好同步，后期会懒得同步，都是手动 方案二：使用git 技巧。在项目工程中希望，其中一个library 工程，既属于本工程， 又属于另
【Git】Git Submodule 介绍（通俗易懂，总结了工作完全够用的 submodule 命令）
Hanson的博客
07-16 7369
git submodules详细操作
Nginx—— sub_module模块详解（Centos7通过yum方式安装）
小志的博客
07-07 1963
一、sub_module的编译参数作用 编译选项 作用 –with-http_sub_module HTTP内容替换 二、http_sub_module的配置 1、sub_filter 模块配置语法 Syntax：sub_filter string replacement string表示要替换的内容；replacement表示替换后的内容 Default：—— 表示默认没有配置 Context：http,server,location 表示需要在http块或server块或locat
ngx_http_sub_module 模块详解
04-01 326
此模块是一个过滤器，它可用一个字符串去替换指定的字符串的修改返回文件。 默认情况下，是不带此模块的，通过--with-http_sub_module使能它。 示例如下： </> location / { sub_filter '<a href="http:...
Git中submodule的使用
ppzzgg666的博客
03-04 2270
当项目比较复杂，部分代码希望独立为子模块进行版本控制时，可以使用 git submodule 功能。使用 git submodule 功能时，主项目仓库并不会包含子模块的文件，只会保留一份子模块的配置信息及版本信息，作为主项目版本管理的一部分。本篇文章简单介绍了 git submodule 的添加和删除，以及项目开发过程中主项目与子模块不同状态时刻的操作方式。
submodule的使用方法
THEGREATHXY的博客
02-20 6559
为什么要用submodule？ 项目的版本库某些情况下需要引用其他版本库中的文件，例如公司积累了一套常用的函数库，被多个项目调用，显然这个函数库的代码不能直接放到某个项目的代码中，而是要独立为一个代码库，那么其他项目要调用公共的函数库，该如何处理呢？分别把公共函数库的文件拷贝到各自的项目中，会造成冗余，丢弃了公共函数库的维护历史，显然不是好的方法。submodule就是解决这个问题的一个方案。 使用方法 在版本库中使用git submodule add命令添加子模组 git submodule add [第
【Git】submodule的使用
张壮壮的博客
04-17 2904
git 的 submodule 功能，提供了单独管理子模块并建立当前项目与子模块之间的依赖关系的功能。在本地修改了子仓的内容，并希望将修改推到远端子仓，但此时我自己在主仓下，如果想要提交子仓的修改，则需进入子模块路径下，按照正常的提交流程提交并push即可，此时就能将修改推到远端子仓。提交、push完后，主仓的状态就是场景2，即主模块下子模块路径下的内容发生了版本变化。文件中的信息设置子模块的url、路径等，但不会下载子模块的内容，仅做初始化。然后进入子模块路径下就可看见子模块的文件了。
Git 中submodule的使用，终于有人说明白了
热门推荐
Java0258的博客
09-11 1万+
背景 面对比较复杂的项目，我们有可能会将代码根据功能拆解成不同的子模块。主项目对子模块有依赖关系，却又并不关心子模块的内部开发流程细节。 这种情况下，通常不会把所有源码都放在同一个 Git 仓库中。 有一种比较简单的方式，是在当前工作目录下，将子模块文件夹加入到.gitignore文件内容中，这样主项目就能够无视子项目的存在。这样做有一个弊端就是，使用主项目的人需要有一个先验知识：需要在当前目录下放置一份某版本的子模块代码。 还有另外一种方式可供借鉴，可以使用 Git 的submod...
Git Submodule
forward
12-18 495
场景：假如A项目团队，有一个项目A，里面有一个不错的网络模块NetModule，这时候B团队的B项目想直接用NetModule，这时候有两种方式进行导入： 方案一：下载A项目，然后将NetModule导入进去 方案二：git submodule的方式，cloneA项目到B项目的lib文件下假如后续过程中A对NetModule进行了修改 方案一需要下载A项目，还要根据哪里修改了，修改自己项目中的
Git 合并时 submodule 冲突
jyf_568的博客
01-03 933
diff --cc src/base index e261b5a7,91eb0ca9..00000000--- a/src/base+++ b/src/base e261b5a7为冲突的页面 先取消暂存更改,改了之后在提交
Git 子模块submodule更新子模块用法，举例详细说明
12-14
首先，在你的主项目目录下，如果还没有子模块，你可以使用 `git submodule add` 命令添加一个新的子模块，例如： ``` git submodule add https://github.com/username/dependency.git submodule-name ``` 2. **...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值