git clone --recursive 中的 --recursive 选项意思是“递归地”克隆一个仓库。它的核心作用是：在克隆主仓库的同时，自动将其所包含的所有子模块（Submodule）也一并克隆下来。

详细解释

1. 什么是子模块 (Submodule)？

子模块是 Git 中的一个强大功能，它允许你将一个 Git 仓库作为另一个 Git 仓库的子目录。这通常用于以下场景：

• 项目依赖：你的主项目依赖另一个独立的库（例如，一个第三方库或一个自己开发的公共组件）。
• 代码复用：为了避免重复造轮子，将通用的代码放在一个独立的仓库中，然后在多个项目中以子模块的形式引用。

例如，你的项目结构可能看起来像这样：

my-main-project/
│
├── src/
├── docs/
│
└── libs/
    └── awesome-dependency/  <-- 这是一个子模块，指向另一个独立的 Git 仓库

2. 不加 --recursive 会怎样？

如果你使用普通的 git clone <项目地址>：

• Git 只会克隆主项目的代码。
• 对于其中的子模块，Git 只会创建一个空文件夹（在这个例子中是 libs/awesome-dependency/），里面没有任何文件。

你需要再手动执行两个命令才能初始化并拉取子模块的代码：

git submodule init    # 初始化本地配置文件
git submodule update  # 从子模块的仓库拉取commit，填充空文件夹

3. 加了 --recursive 会怎样？

使用 git clone --recursive <项目地址>：

• Git 会先克隆主项目。
• 然后，它会自动地、递归地执行 git submodule init 和 git submodule update，把所有子模块的代码也克隆到正确的位置。
• 克隆完成后，你的项目就是完整的、立即可用的状态，所有依赖都已就位。

“递归”的含义：如果一个子模块内部又包含了它自己的子模块，--recursive 选项也会继续递归下去，确保所有层级的依赖都被克隆。这就是“递归”一词的由来。

举个例子

假设有一个仓库 https://github.com/user/main-project，它包含一个子模块，指向 https://github.com/user/shared-lib。

• 普通克隆：

  git clone https://github.com/user/main-project
  cd main-project
  ls ./libs/shared-lib # 这个目录是空的！
  

• 递归克隆：

  git clone --recursive https://github.com/user/main-project
  cd main-project
  ls ./libs/shared-lib # 这个目录里有文件了，子模块已经完整克隆
  

如果我之前忘了加 --recursive 怎么办？

很简单，在已经克隆好的主项目根目录下，执行以下命令即可：

git submodule update --init

如果子模块还有嵌套的子模块，可以再加上 --recursive 来递归初始化更新：

git submodule update --init --recursive

总结

所以，当你克隆一个包含子模块的项目时，最好总是加上 --recursive 参数，这样可以省去后续手动初始化的麻烦，确保代码库的完整性。