Git 如何删除 submodule

要删除 Git 中的 submodule，你需要按照以下步骤操作：这包括从工作区、暂存区和 .gitmodules 文件中移除 submodule，以及清理相应的配置。

1. 删除 submodule 目录： 进入到包含 submodule 的 Git 仓库根目录，然后使用命令删除 submodule 目录。

   bash
   git rm -f path/to/submodule

   这一步将 submodule 从工作区和暂存区（index）中删除。

2. 编辑 .gitmodules 文件： 打开 .gitmodules 文件，找到并删除相关 submodule 的配置部分。这通常包含 path、url 和 branch 等信息。 例如：

   ini
   [submodule "path/to/submodule"]
       path = path/to/submodule
       url = https://github.com/example/submodule.git

   将上述部分完全删除。

3. 编辑 .git/config 文件： 打开 .git/config 文件，在其中找到 submodule 的相关配置并删除。这与 .gitmodules 文件中的内容相似。

4. 删除 submodule 的数据： submodule 的数据存储在 .git/modules 下的对应子目录中。需要手动删除这个目录以清理残留的 submodule 数据。

   bash
   rm -rf .git/modules/path/to/submodule

5. 提交更改： 提交上述所有更改到你的仓库。

   bash
   git commit -am "Remove submodule"

6. 推送更改到远端仓库： 如果你的本地仓库关联了远端仓库，执行下面的命令将更改推送到远端。

   bash
   git push

以上步骤可以确保 submodule 被完全从你的 Git 仓库中删除，包括它的历史记录和配置信息。这样做可以让你的项目结构更干净，也避免了将来的混淆和错误。