Git 子模块

开源生态非常丰富，在实际开发中，我们经常需要在某个的项目包含并使用另一个项目，它也许是第三方库，或许是其他优秀的开源项目，又或者是你自己独立开发项目。反正，你需要在一个项目依赖多个模块。那么，我们该如何管理这些既有关联，由独立的多个项目呢？

答案是 —— Git 子模块（Submodule）

添加子模块

使用 git 的子命令 submodule add 可以为 Git 仓库添加子模块，语法为：

git submodule add <git-repo> [local-path]

例如：

git submodule add git@github.com:luhuadong/ldal.git

或者指定本地的存放目录

git submodule add git@github.com:luhuadong/ldal.git lib/ldal

添加子模块之后，会在 Git 仓库的根目录生成一个 .gitmodules 文件，它保存了 Git 子模块的信息。

[submodule "lib/ldal"]
        path = lib/ldal
        url = git@github.com:luhuadong/ldal.git

拉取子模块

如果首次克隆仓库及其模块，使用：

git clone --recursive 仓库地址

对于仓库首次拉取模块，可以使用：

git submodule update --init --recursive

更新子模块（适用于 git 1.8.2 及以上版本）

git submodule update --recursive --remote

更新子模块（适用于 git 1.7.3 及以上版本）

git submodule update --recursive

或者

git pull --recurse-submodules

更新子模块 url

首先修改 .gitmodules 文件中对应模块的 url 属性值。

然后使用下面命令将新的 URL 更新到文件 .git/config。

git submodule sync

再使用下面命令初始化子模块。

git submodule init

最后使用下面命令更新子模块。

git submodule update

指定 submodule 版本

在 Git 仓库中添加子模块后，cd 切换到子模块目录，然后使用 git checkout 到指定的版本，再提交即可。

参考

• Git – 子模块 (git-scm.com)