Git学习笔记(三) git submodule
1、使用场景
有的时候,我们或许需要在一个项目中包含和使用另外的项目,同时又希望它们能够保持独立的开发
这时,git submodule
就可以很方便地帮我们处理这种情况
它能够将一个仓库作为另外一个仓库的子模块管理,同时保持他们都是独立的提交
2、基本用法
以下是基于父项目的维度管理子模块,在子模块的维度来看,它就和普通的仓库一样
- 添加子模块:
git submodule add
> # 添加子模块到父项目的根目录
> git submodule add <子模块的地址>
> # 添加子模块到父项目指定路径
> git submodule add <子模块的地址> <本地路径>
这时我们可以看到,在父项目的根目录下多了一个 .gitmodules
文件,并且在指定路径中多了一个子模块的目录
.gitmodules
文件记录着子模块仓库与其在父项目中路径的映射关系,因此它需要和子模块一起纳入父项目管理
- 查看子模块:
git status
&&git submodule status
> # 查看状态
> git status
# 第 1 种情况:子模块中有未追踪的内容,此时父项目不能将其放入暂存区
# Changes not staged for commit:
# modified: submodule (untracked content)
#
# 第 2 种情况:子模块中有修改过的内容,此时父项目不能将其放入暂存区
# Changes not staged for commit:
# modified: submodule (modified content)
#
# 第 3 种情况:子模块中有新的提交,此时父项目可以将其放入暂存区
# Changes not staged for commit:
# modified: submodule-children (new commits)
#
# 第 4 种情况:父项目已经将子模块中新的提交放入暂存区
# Changes to be committed:
# modified: submodule-children
> # 查看子模块提交的状态
> git submodule status
- 修改子模块
从子模块的维度来看,其实它就是一个普通的仓库,所有可以应用于普通仓库的操作都可以应用在子模块上
从父项目的维度来看,父项目不会追踪子模块的具体内容,它只会追踪子模块的提交记录
所以,如果子模块的提交记录发生变化,父项目就可以通过 git add
以及 git commit
将其纳入管理
- 更新子模块:
git submodule update
> # 将所有子模块更新为 本地父项目中的子模块仓库最新的版本
> git submodule update
> # 将指定子模块更新为 本地父项目中的子模块仓库最新的版本
> git submodule update <submodule path>
> # 将指定子模块更新为 远程子模块仓库特定分支中最新的版本
> git submodule update --remote
这里需要注意,当执行完 git submodule update
之后,子模块的 HEAD 会处于一个游离的状态
我们需要手动将 update 的内容合并到合适的分支,或者使用 --merge
参数自动合并到当前分支
> git submodule update --merge
- 克隆带有子模块的项目
> # 方法一:递归克隆
> git clone <父项目的地址> --recursive
> # 方法二:先克隆父项目(此时子模块目录为空),然后初始化并更新子模块
> git clone <父项目的地址> && cd <本地仓库>
> git submodule update --init --recursive
【 阅读更多 Git 系列文章,请看 Git学习笔记 】
版权声明:本博客属于个人维护博客,未经博主允许不得转载其中文章。