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