为了读者的利益，这里尝试对它进行总结，并逐步指导如何在无法正常工作的情况下进行操作。以下是测试和安全的方式为git版本2.17及以上摆脱子模块：
submodule="path/to/sub" # no trailing slash!
git submodule deinit -- "$submodule"
git rm -- "$submodule"
- 如果这对您不起作用，请参见下文。
- 没有选择。没什么危险。而且甚至不考虑做更多的事情！
- 在Debian Buster
2.20.1和Ubuntu 18.04上进行了测试2.17.1。
"$submodule" 只是为了强调名称的位置，并且必须注意空格等- 如果在Windows上，则忽略第一行，并
"$submodule"用Windows方式正确指定子模块的路径。（我不是Windows）
警告！
切勿.git自己触摸目录的内部！ 内部编辑.git进入黑暗面。不惜一切代价远离！
是的，您可以git为此负责，因为git过去缺少许多方便的东西。就像重新删除子模块的正确方法一样。
我认为的文档中有一个非常危险的部分git submodule。建议您删除$GIT_DIR/modules/<name>/自己。
以我的理解，这不仅是错误的，而且是非常危险的，并且在将来引起了很多头痛！ 见下文。
注意
git module deinit
是与
git module init
但
git submodule deinit -- module
git rm -- module
也与之相反
git submodule add -- URL module
git submodule update --init --recursive -- module
因为某些命令基本上需要做的不仅仅是一件事情：
git submodule deinit -- module
git rm
- （2）删除模块文件
- （3）从而递归地删除子模块的子模块
- （4）更新
.gitmodules
git submodule add
- 将数据提取到
.git/modules/NAME/
- （1）这样做
git submodule init，所以更新.git/config
- （2）这样做
git submodule update，因此，非递归地检出模块
- （4）更新
.gitmodules
git submodule update --init --recursive -- module
这不能完全对称，因为使其严格对称没有太大意义。根本不需要两个以上的命令。另外，“拉入数据”是隐式的，因为您需要它，但不会删除缓存的信息，因为根本不需要这样做，并且可能会擦除珍贵的数据。
这确实使新手感到困惑，但基本上是一件好事： git只做明显的事情，做对了，甚至不尝试做更多的事情。 git是一种工具，必须做得可靠，而不仅仅是另一个“ Eierlegende Wollmilchsau”（“ Eierlegende Wollmilchsau”对我来说是“瑞士军刀的某种邪恶版本”）。
所以我理解人们的抱怨，说：“为什么不git为我做明显的事情”。这是因为这里的“明显”取决于观点。在每种情况下的可靠性都更为重要。因此，在所有可能的技术情况下，通常对您而言显而易见的事情并不是正确的选择。请记住：AFAICS git遵循技术路线，而不是社会路线。（因此，聪明的名字是：git）
如果失败
上面的命令可能由于以下原因而失败：
- 你
git太老了。然后使用更新的git。（请参阅下面的方法。）
- 您有未提交的数据，并且可能会丢失数据。然后最好先提交他们。
- 从
git clean某种意义上说，您的子模块不干净。然后，首先使用该命令清理您的子模块。（见下文。）
- 您过去所做的事情不受的支持
git。然后，您处于阴暗面，事情变得丑陋而复杂。（也许使用另一台计算机对其进行了修复。）
- 也许还有更多我不知道的失败方法（我只是一些
git高级用户。）
可能的修复方法如下。
使用较新的 git
如果你的机器太旧，没有submodule deinit在你的git。如果您不想（或可以）更新您的计算机git，则只需使用另一台更新的计算机即可git！ git是完全分布式的，因此您可以使用另一个git来完成工作：
workhorse:~/path/to/worktree$ git status --porcelain 一定不要输出任何东西！如果是这样，请先清理东西！workhorse:~/path/to/worktree$ ssh account@othermachineothermachine:~$ git clone --recursive me@workhorse path/to/worktree/.git TMPWORK && cd TMPWORK- 现在做子模块的东西
othermachine:~/TMPWORK$ git commit . -m . && exitworkhorse:~/path/to/worktree$ git fetch account@othermachine:TMPWORK/.gitworkhorse:~/path/to/worktree$ git merge --ff-only FETCH_HEAD。如果这不起作用，请使用git reset --soft FETCH_HEAD- 现在清理事物，直到
git status再次清理。您可以这样做，因为由于第一步，您之前已经将它清理干净。
这othermachine可能是一些虚拟机，或者一些Ubuntu的WSL Windows下，不管。甚至一个chroot（但我假设您不是root用户，因为如果是root，则更容易将其更新为较新的版本git）。
请注意，如果您不能ssh进入，则有许多方法来运输git存储库。您可以将工作树复制到某些USB记忆棒（包括.git目录）上，然后从该记忆棒克隆。克隆副本，只是为了以一种干净的方式再次获取内容。如果您的子模块不能直接从其他计算机访问，则这可能是PITA。但是也有一个解决方案：
git config --add url.NEWURLPREFIX.insteadOf ORIGINALURLPREFIX
您可以使用此乘法，并将其保存到中$HOME/.gitconfig。就像是
git config --add 'url./mnt/usb/repo/.insteadof' https://github.com/
重写类似的URL
https://github.com/XXX/YYY.git
进入
/mnt/usb/repo/XXX/YYY.git
如果您开始习惯这样的强大git功能，这很容易。
首先清理事情
手动清理是个好习惯，因为这样您可能会发现一些忘记的事情。
- 如果git抱怨未保存的内容，请提交并推送到安全的地方。
- 如果混帐抱怨一些剩菜，
git status并且git clean -ixfd是你的朋友
- 尝试从选项弃权
rm和deinit，只要你能。如果您是专业人士-f，git则提供的选项（如）会很好。但是当您来到这里时，您可能在该submodule地区没有那么丰富的经验。因此，最好不要后悔。
例：
$ git status --porcelain
M two
$ git submodule deinit two
error: the following file has local modifications:
two
(use --cached to keep the file, or -f to force removal)
fatal: Submodule work tree 'two' contains local modifications; use '-f' to discard them
$ cd two
$ git submodule deinit --all
error: the following file has local modifications:
md5chk
(use --cached to keep the file, or -f to force removal)
fatal: Submodule work tree 'md5chk' contains local modifications; use '-f' to discard them
$ cd md5chk
$ git submodule deinit --all
error: the following file has local modifications:
tino
(use --cached to keep the file, or -f to force removal)
fatal: Submodule work tree 'tino' contains local modifications; use '-f' to discard them
$ cd tino
$ git status --porcelain
?? NEW
$ git clean -i -f -d
Would remove the following item:
NEW
*** Commands ***
1: clean 2: filter by pattern 3: select by numbers 4: ask each
5: quit 6: help
What now> 1
Removing NEW
$ cd ../../..
$ git status --porcelain
$ git submodule deinit two
Cleared directory 'two'
Submodule 'someunusedname' (https://github.com/hilbix/src.git) unregistered for path 'two'
您知道，-f不需要submodule deinit。从git clean某种意义上说，如果一切都干净。另请注意，这git clean -x不是必需的。 这意味着git submodule deinit无条件删除被忽略的未跟踪文件。 这通常是您想要的，但不要忘记它。有时，被忽略的文件可能很珍贵，例如缓存的数据需要数小时至数天才能重新计算。
为什么从不删除$GIT_DIR/modules/<name>/？
人们可能想删除缓存的存储库，因为他们害怕以后会遇到问题。的确如此，但是遇到“问题”才是解决问题的正确方法！因为修复很容易，而且操作正确，您以后就可以过上幸福的生活。与您自己删除数据相比，这避免了麻烦的麻烦。
例：
mkdir tmptest &&
cd tmptest &&
git init &&
git submodule add https://github.com/hilbix/empty.git two &&
git commit -m . &&
git submodule deinit two &&
git rm two &&
git commit -m . &&
git submodule add https://github.com/hilbix/src.git two
最后一行输出以下错误：
A git directory for 'two' is found locally with remote(s):
origin https://github.com/hilbix/empty.git
If you want to reuse this local git directory instead of cloning again from
https://github.com/hilbix/src.git
use the '--force' option. If the local git directory is not the correct repo
or you are unsure what this means choose another name with the '--name' option.
为什么会出现这个错误？因为.git/modules/two/以前是从https://github.com/hilbix/empty.git填充的，现在应该从其他地方（即https://github.com/hilbix/src.git）重新填充。如果您从https://github.com/hilbix/empty.git重新填充它，您将看不到它。
现在做什么？好吧，完全按照指示执行！采用--name someunusedname
git submodule add --name someunusedname https://github.com/hilbix/src.git two
.gitmodules 然后看起来像
[submodule "someunusedname"]
path = two
url = https://github.com/hilbix/src.git
ls -1p .git/modules/ 给
someunusedname/
two/
将来通过这种方式，您可以向前和向后切换分支/提交，并且由于two/拥有两个不同的（并且可能不兼容的）上游存储库，因此永远不会再遇到任何麻烦。最好的是：您也将两者都保留在本地缓存。
- 这不仅对您如此。使用存储库的所有其他用户也是如此。
- 而且您不会失去历史。如果您忘记推送最新版本的旧子模块，则可以输入本地副本，稍后再输入。请注意，很普遍有人忘记推送某些子模块（因为这是新手的PITA，直到他们习惯了
git）。
但是，如果您删除了缓存的目录，则两个不同的检出都将相互混淆，因为您将不会使用这些--name选项，对吗？因此，每次执行结帐操作时，您可能不得不.git/modules/<module>/一次又一次地删除目录。这非常麻烦，并且很难使用git bisect。
因此，将这个模块目录保留为占位符是非常技术性的原因。建议删除以下内容的人.git/modules/可能不太了解，或者忘记告诉您这会使强大的功能（git bisect如果遇到子模块不兼容的情况）几乎无法使用。
上面显示了另一个原因。看看ls。您在那看到什么？
好吧，模块的第二个变种two/不在下.git/modules/two/，它在下.git/modules/someunusedname/！所以这样的事情git rm $module; rm -f .git/module/$module是完全错误的！您必须咨询module/.git或.gitmodules找到合适的东西删除！
因此，不仅大多数其他答案都陷入了这一危险陷阱，即使是非常受欢迎的git扩展程序都存在此错误（现已在此处修复）！因此，.git/如果您不完全了解自己在做什么，最好还是掌握一下目录！
从哲学的角度来看，抹除历史总是错误的！
除了量子力学，像往常一样，但这是完全不同的。
仅供参考，您可能会猜到：hilbix是我的GitHub帐户。
git rm modulename和rm -rf .git/modules/modulename