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学习笔记

上一篇:Git学习指南第11章


下一篇:git subtree submodule