如果您刚刚添加了子模块，例如，您只是添加了错误的子模块或将其添加到了错误的位置，只需执行git stash，然后删除文件夹。这是假设添加子模块是您在最近的回购中唯一做的事情。

您必须删除.gitmodules和.git/config中的条目，并从历史记录中删除模块的目录：

git rm --cached path/to/submodule

如果你在git的邮件列表上写东西，很可能有人会为你编写一个shell脚本。

在现代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 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

这对我有用。上面的答案在终端中显示了这一点，没有发生其他事情

'fatal: not removing 'demolibapp' recursively without -r'

demolibapp是我要删除的子模块名称git子模块deinit分解git rm—缓存的demolibapp-rrm-rf.git/modules/demolibappgit add--全部gitcommit-m“删除额外的子模块”数字推送rm-rf脱模剂

总而言之，这是您应该做的：

设置path_to_submodule变量（无尾随斜杠）：

path_to_submodule=path/to/submodule

从.gitmodules文件中删除相关行：

git config -f .gitmodules --remove-section submodule.$path_to_submodule

从.git/config中删除相关部分

git config -f .git/config --remove-section submodule.$path_to_submodule

仅从索引中取消存储并删除$path_to_submodule（以防止丢失信息）

git rm --cached $path_to_submodule

跟踪对.gitmodules所做的更改

git add .gitmodules

提交超级项目

git commit -m "Remove submodule submodule_name"

删除现在未跟踪的子模块文件

rm -rf $path_to_submodule

rm -rf .git/modules/$path_to_submodule

另请参见：备选指导线