git的submodule用法

submodule介绍

submodule，即子模块，在项目中添加一个submodule就相当于引用了一个别的repo，记下来我将分别针对不同的情形展开讨论

添加submodule

在main project当中：

git submodule add <submodule_url> <path>

其中，submodule_url为submodule的repo地址，path为接下来clone的地址。运行之后，会发现目录下多出了.gitmodule文件。

已经clone了一个项目，添加为submodule

和上面一样：

git submodule add <submodule_url> <path>

改动了submodule内的代码

首先明确一个概念：submodule是一个独立、完整的repo。这意味着，你可以像往常一样在submodule的根目录下进行add/commit/push，这都是完全没有问题的。但是，如果submodule没有commit，主项目是无法commit的，所以如果要commit主项目，首先要确保submodule内各个项目都没有问题。在此之外，当submodule内已经好了之后，我们便可以commit主项目，并可以发现主项目当中submodule是作为一个整体来计算的。

删除submodule

写在一个子模块：

git submodule deinit

如果：

git submodule deinit --force

那么即使本地repo有未提交的更改也会被移除. 上述命令是删除.git/config中的配置文件，若要继续删除本地的文件：

git rm <submodule>

来删除。

操作完毕之后我们发现主项目就有更改了，进行commit来提交更改：

git commit -m "Deleted the submodule project."

submodule有远程更新

cd <path>
git pull origin master

如果有多个submodule，可以：

git submodule foreach 'git pull origin master'

clone带有submodule的项目

git clone <repo-url> --recurse-submodules

或者：

git clone <repo-url>
git submodule init
git submodule update