git的submodule功能详解

gitsubmodule功能详解

1. 前言

项目的版本库在某些情况下需要引用其他版本库中的文件,例如有一套公用的代码库,可以被多个项目调用,这个公用代码库能直接放在某个项目的代码中,而是要独立为一个代码库,那么其他要调用公用的代码库该如何处理?分别把公用的代码库拷贝到各自的项目中会造成冗余,丢弃了公共代码库的维护历史,这些显示不是好的办法,现在要了解的git子模组(git submodule)就解决了这个问题。

Git 子模块功能允许你将一个Git仓库当作另外一个Git仓库的子目录。这允许你克隆另外一个仓库到你的项目中并且保持你的提交相对独立。

2. 准备工作

首先需要两个版本库例如:

1) 一个公共的版本库(例如:libA.git)

git@gitlab.szreach.com:fengyang/liba.git

2) 一个引用公共版本库的主版本库(例如:super.git)

git@gitlab.szreach.com:fengyang/super.git

3. TortoiseGit上git submodule功能实现

1. 添加子模组的步骤

第一步:使用submodule add...添加子模组

在需要作添加子模组的Git版本库中右击,选择“TortoiseGit->Submodule Add...,在“Repository:”里面输入需要添加子模组的版本库路径,在“Path:

中输入添加子模组存放的目录路径。如下图所示:

Git的submodule功能详解

此时查看需要添加子模组的Git工作区的目录结构。在根目录下多了一个.gitmodules文件,并且公共代码库被克隆到lib/lib_a目录下。

Git的submodule功能详解

第二步:查看.gitmodules的内容

.gitmodules的内容记录着含子模组存放的目录路径及子模组版本库的路径

Git的submodule功能详解

注:此时工作区尚未提交,完成提交后,子模组才算正式完成在需要作添加子模组的Git版本库创立

注:此主版本库(super.git)就变成了一个包含子模组的版本库。

2. 克隆带子模组的版本库的步骤

克隆带子模组的git库,并不能自动将子模组的版本库克隆出来,对于只关心项目本身的数据,而不关心项目引用的外部项目数据的用户,这个功能非常好,数据没有冗余而且克隆的速度也很快。

第一步:克隆super主版本库

在工作区中克隆主主版本库后,会发现子模组的版本库并没有克隆,只有将存放子模组版本库的目录克隆下来了。

Git的submodule功能详解

Git的submodule功能详解----:存放子模组版本库的目录路径

第二步:克隆子模组

如果需要克隆出子模组形式引用的外部库,首先需要执行Submodule Update操作。

在需要作克隆子模组的Git工作区中右击,选择“TortoiseGit->Submodule Update...,点击“OK”即可。

Git的submodule功能详解

执行Submodule Update...操作后就会把子模组的版本库克隆下来。

Git的submodule功能详解

3. 对主Git库工作区作commitcheckoutrevertpullpush等更改Git工作区内容的操作时,查看Submodule目录下内容的效果

1) 对主Git库工作区作commit操作

当在主Git库工作区中变更到达一个适当状态时,我们需要将这些变更提交到Git库,作版本备份和跟踪。

方法:

在工作区内右击,选择“ Commit-> "当前分支名称”,在Commit窗口中,选择需要提交的变更path,填写提交说明,点击“Ok”。

Git的submodule功能详解

结论:在主git工作区作commit操作,只是将主Git工作区的变更历史提交到主Git本地库中,对Submodule没有任何影响。

2) 对主Git库工作区作checkout操作

当在主Git库工作区中想要切换到其他某个分支、某个tag、某个commit历史记录。

我们这里举个特殊的例子:

切换到某个commit历史记录(如在主版本库中提交子版本库的历史记录)

方法:

Git工作区内的某目录上右击,选择“Swicht/Checkout...”在Swicht/Checkout...Checkout窗口中,在Switch to Commmit中列出需要切换的commit历史记录,在此列表中选择需要切换到的commit历史记录,以后点击“Ok”按钮。

Git的submodule功能详解

Git的submodule功能详解

Git的submodule功能详解

注:由于切换到的是在主版本库中提交子版本库的那条历史记录,因此子模组中状态也会改换,也需要在子模组中执行切换。

执行Submodule Update操作即可。

Git的submodule功能详解

3) 对主Git库工作区作revert操作

当在主Git库工作区中这次变更有错误时,就可以使用revert操作来撤销这次次操作

方法:

在工作区内右击,选择“Revert”,在Revert窗口中,选择需要撤销的变更path,点击“Ok”。

Git的submodule功能详解

Git的submodule功能详解

结论:在主git工作区作revert操作,只是将主Git工作区某次的变更操作给撤销,此次操作之前的commit都会被保留,且对Submodule没有任何影响。

4) 对主Git库工作区作push操作

当在主Git库工作区中将主Git本地库的数据推送到主Git远程库中

方法:在工作区的目录上(不要在文件上)右击,选择“Git Sync...

"Local Branch""Remote Branch",“Remote URL”这3栏必须正确才能“推”数据。

Git的submodule功能详解

结论:在主git工作区作push操作,只是将主Git本地库的变更历史推送到到主Git远程库中,对Submodule没有任何影响。

5) 对主Git库工作区作pull操作

当在主Git库工作区中将主Git远程库的拉取到主Git本地库中

方法:在工作区的目录上(不要在文件上)右击,选择“Git Sync...

"Local Branch""Remote Branch",“Remote URL”这3栏必须正确才能“拉”数据。

Git的submodule功能详解

结论:在主git工作区作pull操作,只是将主Git远程库的变更历史拉取到到主Git本地库中,对Submodule没有任何影响。

4. submodule下的内容进行修改后commitpush,对submodule目录作pull

在执行Submodule Update...操作更新出子模组后,都以某个具体的提交版本进行检出,进入子模组目录,会发现其处于非跟踪状态。

Git的submodule功能详解

显然这种情况下,如果修改lib/lib_a下的文件,提交就会丢失。下面介绍如何在检查的子模组中修改,以及如何更新子模组。

在子模组中切换到master分支(或者其他想要修改的分支)后在进行修改。

l 切换到master分支,然后在工作区做一些改动。

Git的submodule功能详解

l 执行commit后,并且推送到子模组库中后。

l 回到主版本库中。

在主版本库中查看状态,在主版本库中可以看到子模组已修改,包含了更新的提交。

l 需要将修改提交在主版本库中进行推送。

Git的submodule功能详解

submodule目录作pull

当子模组版本库中有新的提交历史记录,就需要做pull操作来更新。

Git的submodule功能详解

注:对子模组库中做了pull操作,同时需要对调用子模组库的主版本库中也要做Pull操作。

如下图所示:

Git的submodule功能详解

注意:进入子模组目录,会发现其处于非跟踪状态。显然这种情况下,如果修改lib/lib_a下的文件,提交就会丢失。提示如下:

Git的submodule功能详解

5. 移除Submodule

第一步:用Delete(keep local) 将目录或文件命令从git的索引库中移除子模块目录

方法:

在工作区内目录或文件上右击,选择“Delete(keep local)”,在Delete窗口中,点击“Remove”。

Delete(keep local)把目录lib/git的索引库中移除,但是对目录lib/本身并不进行任何操作。

因此需要彻底删除。

第二步:删除物理文件

第三步:删除.gitmodule文件

第四步:删除.git/configsubmodule配置源文件

删除如下图所示红框的部门

Git的submodule功能详解

第五步:删除后,提交更改

 

 

http://www.kafeitu.me/git/2012/03/27/git-submodule.html
### Git 子模块的概念 Git 子模块允许一个 Git 仓库作为另一个 Git 仓库的子目录存在,同时保持独立。这意味着可以在主项目中嵌入其他项目的依赖关系而不破坏其自身的结构[^1]。 ### 添加子模块 要在现有项目中添加一个新的子模块,可以使用 `git submodule add` 命令: ```bash git submodule add http://xxx:xx/XieXiaohan/test2b.git path/to/submodule ``` 这会克隆指定 URL 的仓库并将其放置在给定路径下。如果省略路径参数,则默认会在与远程仓库名称相同的文件夹内创建该子模块。 ### 初始化和更新子模块 当首次检出包含子模块的新存储库时,需要初始化这些子模块,并获取它们的数据: ```bash git submodule init # 初始化本地配置文件 git submodule update # 获取所有数据并在必要时检出适当提交 ``` 对于已经存在的工作树中的更改,可以通过运行上述命令来同步最新的改动。 ### 提交含有子模块变更的修改 一旦对某个子模块进行了任何改变——无论是版本升级还是降级——都需要回到父项目根目录执行如下操作以记录新的哈希值: ```bash cd .. git add path/to/submodule git commit -m 'Updated the submodule to a new version' ``` 这样做的目的是让父项目的快照能够反映当时所使用的特定状态下的子模块版本信息。 ### 删除子模块 要移除不再需要的子模块,首先要编辑 `.gitmodules` 文件删除对应的条目;其次,在`.git/config` 中也做相应调整;最后通过下面的方式清理残留的工作副本以及索引项: ```bash rm -rf .git/modules/path/to/submodule/ git rm path/to/submodule ``` 请注意,以上步骤不会影响原始外部资源的位置或内容。 ### 工作流程建议 为了更好地管理多个子模块,推荐定期检查是否有可用更新,并及时处理冲突情况。此外,还可以考虑设置钩子(hooks),以便自动化某些重复性的任务,比如自动拉取最新变化等。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值