删除git子模块

要删除git子模块，需要以下4个步骤。

删除.gitmodules文件中的相应条目。条目可能如下所述

[submodule "path_to_submodule"]
    path = path_to_submodule
    url = url_path_to_submodule

阶段更改gitadd.gitmodules删除子模块目录git-rm-cached<path_to_submodule>。提交gitcommit-m“Removed submodule xxx”并推送。

下面提到的另外两个步骤需要完全清除本地克隆副本中的子模块。

删除.git/config文件中的相应条目。条目可能如下所述

[submodule "path_to_submodule"]
    url = url_path_to_submodule

执行rm-rf.git/modules/path_to_submodule

第5步和第6步不会产生任何需要提交的更改。

简单的步骤

删除配置项：git-config-f.git/config--删除节子模块$submodulename git-config-f.gitmodules—删除部分子模块$子模块名称从索引中删除目录：git rm--cached$submodule路径犯罪删除未使用的文件：rm-rf$submodulepathrm-rf.git/modules/$submodulename

请注意：$submodulepath不包含前导或尾随斜杠。

出身背景

当您执行git子模块add时，它只将其添加到.gitmodules中，但是完成git子模块init后，它将添加到.git/config中。

因此，如果您希望删除模块，但能够快速恢复，那么就这样做：

git rm --cached $submodulepath
git config -f .git/config --remove-section submodule.$submodulepath

首先执行git rebase HEAD和git commit是一个好主意最后，如果你把这个写在脚本中。

还可以看看我可以取消填充Git子模块吗？的答案？。

我遵循了同一指南的指示如何删除子模块？

$ git submodule deinit -f <submodule-name>
$ rm -rf .git/modules/<submodule-name>
$ git config -f .gitmodules --remove-section submodule.<submodule-name>
$ git config -f .git/config --remove-section submodule.<submodule-name>
$ git rm --cached <submodule-name>
$ git commit -m 'rm submodule: <submodule-name>'

但它一直在说：

fatal: no submodule mapping found in .gitmodules for path

因此，我所做的是像这样在.gitignore中包含路径（路径末尾没有星号）：

<path>

然后我修改了任何文件并进行了简单的推送：

$ git add .
$ git commit -m "Ignoring sharedlibs folder <path> on .gitignore"
$ git push -u origin master

在现代git中（我在2022年编写了这篇文章，并更新了git安装），这变得非常简单：

运行git-rm＜path to submodule＞并提交。

这将删除<path to submodule>处的文件树，以及.gitmodules文件中的子模块条目。即，删除存储库中子模块的所有痕迹。

然而，正如文档所指出的，子模块的.git目录（在主项目.git目录的模块/目录中）被保留了下来，“这样就可以在不需要从另一个存储库获取的情况下签出过去的提交”。如果您仍然想删除此信息，请手动删除.git/modules/中的子模块目录，并删除.git/config文件中的子模板条目

rm-rf.git/modules/<子模块路径>，以及git-config—删除节子模块<子模块路径>。

较旧的社区wiki说明：

通过Git子模块教程页面：

要删除子模块，您需要：

从.gitmodules文件中删除相关部分。暂存.gitmodules更改：git-add.gitmoduls从.git/config中删除相关部分。从工作树中删除子模块文件，并索引：git rm--cached path_to_submodule（无斜杠）。删除子模块的.git目录：rm-rf.git/modules/path_to_submodule提交更改：gitcommit-m“已删除子模块<name>”删除现在未跟踪的子模块文件：rm-rf path_to_submodule

另请参见：以下替代步骤。

这个问题的大多数答案都过时、不完整或不必要的复杂。

使用git 1.7.8或更高版本克隆的子模块将在您的本地存储库中最多留下四条自己的痕迹。删除这四个轨迹的过程由以下三个命令给出：

# Remove the submodule entry from .git/config
git submodule deinit -f path/to/submodule

# Remove the submodule directory from the superproject's .git/modules directory
rm -rf .git/modules/path/to/submodule

# Remove the entry in .gitmodules and remove the submodule directory located at path/to/submodule
git rm -f path/to/submodule

我最近发现了一个git项目，其中包含许多有用的git相关命令：https://github.com/visionmedia/git-extras

安装并键入：

git-delete-submodule submodule

然后事情就完成了。子模块目录将从repo中删除，并且仍然存在于文件系统中。然后可以提交更改，如：gitcommit-am“Remove the submodule”。