除了这些建议之外，我还必须rm-Rf.git/modules/path/to/submodule，才能添加一个同名的新子模块（在我的例子中，我用原来的fork替换了一个fork）

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

$ 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

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

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

设置path_to_submodule变量（无尾随斜杠）：path_to_submodule=路径/到/子模块从.gitmodules文件中删除相关行：git-config-f.gitmodules—删除节子模块$路径_子模块从.git/config中删除相关部分git-config-f.git/config—删除节子模块$路径_子模块仅从索引中取消存储并删除$path_to_submodule（以防止丢失信息）git rm--缓存的$path_to_submodule跟踪对.gitmodules所做的更改git-add.gitmodules提交超级项目gitcommit-m“删除子模块子模块名”删除现在未跟踪的子模块文件rm-rf$path_to_submodulerm-rf.git/modules/$path_to_submodule

我发现deinit对我很好：

git submodule deinit <submodule-name>    
git rm <submodule-name>

从git文档：

解交织注销给定子模块，即删除整个子模块$名称git/config中的部分及其工作树。

要删除添加的子模块，请使用：

REPOSITORY=blah@blah.com:repos/blah.git
MOD_DIR=lib/blah
git submodule add $REPOSITORY $MOD_DIR

Run:

git rm $MOD_DIR

就是这样。

对于旧版本的git（约为1.8.5，实际上甚至在2.26.2中），请使用：

git submodule deinit $MOD_DIR
git rm $MOD_DIR
git config -f .gitmodules --remove-section submodule.$MOD_DIR