git 子模块 submodule

子模块【Sub-Module】

子模块允许你将一个 Git 仓库当作另外一个Git仓库的子目录。克隆另外一个仓库到的项目中并与自己的提交相对独立。类似于java中的组合。

添加一个子模块

$ git submodule add url.git [本地目录]

本地目录会默认当前目录。
notes: 无论如果没有clone会自动clone，已clone会自动更新。
这时运行 git status，你会注意到多了两条

	new file:   .gitmodules
	new file:   XXX

.gitmodules 配置文件保存了项目 URL 与已经拉取的本地目录之间的映射(path、url)

XXX是工作目录中的一个子目录，但 Git 还是会将它视作一个子模块。当你不在那个目录中时，Git 并不会跟踪它的内容， 而是将它看作子模块仓库中的某个具体的提交。

查看子模块

$ git submodule

克隆一个带子模块的项目

克隆一个带有子模块的仓库，下来之后有模块目录，不过是空的。 你必须运行两个命令：

自动初始化并更新仓库中的每一个子模块， 包括可能存在的嵌套子模块

$ git clone --recurse-submodules url

对已经克隆了的项目

1. 初始化本地配置文件

$ git submodule init

2. 从该项目中抓取所有数据并检出父项目中列出的合适的提交。

$ git submodule update

3. 可以将 git submodule init 和 git submodule update 合并成一步。

$ git submodule update --init

4. 如果有嵌套，可以加上 --recursive 进行递归。