Git Submodule 常用命令详解

Git Submodule 是一种让 Git 仓库作为另一个 Git 仓库的子目录的方法。这在管理大型项目时非常有用，特别是当项目依赖于其他项目或库时。以下是一些 Git Submodule 的常用命令及其用法。

1. 查看子模块

要查看当前项目中配置的所有子模块信息，可以使用以下命令：

git submodule

或者，如果你想要更详细的输出，包括子模块的路径和提交的哈希值，可以使用：

git submodule status

2. 更新子模块

更新到本地配置的版本

如果你想要更新子模块到其本地配置（.gitmodules 文件中指定的）的提交版本，可以使用：

git submodule update

更新到远程项目的最新版本

如果你想要将子模块更新到其远程仓库的最新提交，可以使用 --remote 选项：

git submodule update --remote

这将会使子模块跟踪其远程分支的最新提交。

3. 克隆包含子模块的项目

分步克隆

1. 克隆父项目：

   git clone https://github.com/demo.git assets
   

2. 初始化子模块：

   在克隆了父项目之后，需要初始化子模块配置：

   git submodule init
   

3. 更新子模块：

   初始化之后，使用以下命令来拉取子模块的代码：

   git submodule update
   

递归克隆

如果你想要一次性克隆父项目及其所有子模块，可以使用 --recursive 选项：

git clone https://github.com/demo.git assets --recursive

这将会递归地克隆所有子模块。

4. 递归更新整个项目的子模块

如果你已经克隆了项目（可能未使用 --recursive），但之后想要更新所有子模块到最新状态，可以使用：

git submodule foreach git pull

这个命令会遍历所有子模块，并在每个子模块中执行 git pull 命令，以更新到最新的远程分支状态。

删除子模块

删除子模块需要两个步骤：从 .gitmodules 文件中移除子模块的配置，并从 .git/config 文件中移除相关配置，然后删除子模块目录及其 .git 目录（如果存在）。但通常，使用以下命令可以简化这个过程：

git rm --cached subModulesA
rm -rf subModulesA

注意：subModulesA 是你想要删除的子模块的目录名。这条命令首先会从 Git 索引中移除子模块（但不会从文件系统中删除），然后你需要手动删除子模块的目录。