git submodule管理的仓库怎么删除子仓库

绛洞花主敏明2025-03-11 9:00

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

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

bash 复制代码

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

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

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

bash 复制代码

rm -rf <子模块路径>

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

plaintext 复制代码

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

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

bash 复制代码

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

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

bash 复制代码

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

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

bash 复制代码

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

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

bash 复制代码

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

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

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