【git】git clone --recursive 参数

git clone --recursive 是 Git 的一个参数，用于递归地克隆目标仓库及其所有子模块。参数 --recursive 确保不仅克隆主仓库，还会同时克隆所有相关的子模块。

代码说明

git clone -b v9.6.0 --recursive https://github.com/cupy/cupy.git

• git clone：用于克隆一个 Git 仓库到本地。
• -b v9.6.0：指定要克隆的分支或标签，在这里是指定 Cupy 的版本 v9.6.0。
• --recursive：表示在克隆主仓库时，还会克隆主仓库中所有已配置的子模块。
• https://github.com/cupy/cupy.git：GitHub 上 Cupy 项目的 URL。

子模块（Submodule）介绍

在一些复杂的项目中，可能会依赖其他外部的 Git 仓库。这些外部仓库被称为“子模块”。当一个项目使用子模块时，Git 会记住子模块的项目地址和特定的版本信息（或 URL 和分支等信息）。

• 当你使用 git clone 不带 --recursive 参数时，Git 会克隆主仓库，但不会自动克隆子模块。
• 使用 git clone --recursive 后，Git 会克隆主仓库的同时，将主仓库中所有已配置的子模块也一并克隆下来。

为什么 Cupy 需要子模块？

Cupy 是一个用于 GPU 加速计算的库，它可能依赖于其他独立开发的库或工具（如 CUDA 运行时库等）。这些依赖的库可能作为子模块被嵌套在 Cupy 的主仓库中。如果你需要编译或运行 Cupy 的某些功能模块，可能就需要这些子模块的内容。

如果你运行上述命令后，发现某些依赖未正确克隆，可以尝试以下命令手动更新子模块：

git submodule update --init --recursive

这一命令会初始化并克隆所有子模块到本地。