删除 Git 子模块需要执行一系列步骤，以确保从项目中彻底移除子模块及其相关配置。以下是详细的步骤：

1. 取消初始化子模块

运行以下命令以取消子模块的初始化，这会从 .git/config 文件中移除子模块的配置：

git submodule deinit -f <子模块路径>

-f 参数用于强制执行，避免因子模块目录中有未提交的更改而导致命令失败。

2. 删除子模块目录

从工作目录中删除子模块的文件夹：

rm -rf <子模块路径>

3. 从 .gitmodules 文件中移除子模块

编辑 .gitmodules 文件，找到与子模块相关的条目并删除，例如：

[submodule "<子模块路径>"]
    path = <子模块路径>
    url = <子模块仓库地址>

也可以通过命令直接删除：

git config -f .gitmodules --remove-section submodule.<子模块路径>

4. 从 Git 缓存中移除子模块

运行以下命令以从 Git 缓存中移除子模块：

git rm --cached <子模块路径>

5. 清理 .git 目录中的子模块文件

删除子模块在 .git/modules 目录中的相关文件：

rm -rf .git/modules/<子模块路径>

6. 提交更改

将所有更改提交到 Git 仓库：

git add .gitmodules
git commit -m "Remove submodule: <子模块路径>"
git push

7. 可选：清理 .git/config 中的子模块配置

如果需要，可以手动编辑 .git/config 文件，删除与子模块相关的条目。

完成以上步骤后，子模块将从项目中彻底移除，且不会影响外部子模块仓库。