git submodule的用法

---

1. git submodule介绍

通常在公司的项目中，自己开发的模块要用到别人的模块，两个模块是单独管理、发布的，这就需要用到git submodule功能。

在git管理的项目中，通常看到.gitmodules这个文件，如下图：

这个文件就是，通过执行git submodule命令生成的，具体怎么构建呢？请继续阅读。

---

2. 命令

当前自己的项目A中还没有引入项目B，可以在A项目下通过下面的命令添加：

git submodule add https://xxxxxxxxxxx.git ./a_1/B

执行完后，可以看到，在目录：a_1/B下就有了B项目的代码，而且在A的主目录下生成了.gitmodules文件。

当push A项目是，a_1/B下的代码不会被push上去的，相当于两个项目被单独管理了。

当别人拉了A项目，需要在A项目的主目录下执行:

git submodule update --init --recursive

这样，就将A项目依赖的B项目全部拉下来了。

注意：
如果，遇到了冲突问题，可能是之前构建过B项目的目录，请参考【4】、【5】解决。

---

3. 参考

【1】 Git submodule 子模块的管理和使用
【2】 Git中submodule的使用
【3】 git中submodule子模块的添加、使用和删除
【4】 git submodule: already exists in the index
【5】 git 子模块更改默认目录相关错误