git clone --recursive慢_Git使用之submodule

入职第一周，就因为clone项目而产生了很大的障碍，花了差不多三四个小时才定位问题并解决，记录一下。

---

一、问题

当我们在使用Git克隆项目的时候，无法克隆下来一个文件夹。记该文件夹为A，A在远程仓库是有的，也能点开看到，而克隆下来后，本地A点开后是空的，什么也没有。

A的特征为，其后面跟着一个 @xxxxxxx，xxxxxxx为一串数字。

远程仓库中A的示意图

二、问题演示

1、在Git Bash中克隆远程仓库，指令如下：

git clone https://github.com/Aq-audio/work-record

拷贝本地文件如下所示

而远程仓库如下所示

2、继续点开submodule文件夹。

本地如下所示

而远程仓库点开后如下所示

3、问题出现了：本地上啥也没有，而远程仓库中却有文件——README.md。

三、定位问题

核心在于，submodule文件夹是一个子项目，在远程仓库中，其后面的 @xxxxxxx是子项目的标识。

submodule的具体使用大家可以看Git Book的描述，在此不加以赘述。

Git - 子模块​git-scm.com

四、解决问题

在本地中，Git Bash进入最开始拷贝得到的文件夹，本例中，该文件夹是 work-record，如下所示

输入指令

git submodule update --init --recursive

此时，再进入本地的submodule文件夹，可以看到，已经将远程仓库中该文件夹下的文件拷下来了。

其它方法：

1、在最开始的时候，看到有这种子项目的项目，直接用以下指令拷贝。

git clone --recursive https://github.com/Aq-audio/work-record

便可以一步到位将所有的子项目拷到本地来。

2、使用visual studio拉取项目，选择递归式拉取。

同样的，如果一个大项目中，有子项目，子项目下面又有子项目，也是一样的操作方法。