删除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步不会产生任何需要提交的更改。

自git1.8.3（2013年4月22日）起：

一旦你用“gitsubmoduleInit”表达了对某个子模块的兴趣，就没有瓷的方式来表示“我不再对这个子模块感兴趣了”。“git submodule deinit”是这样做的方法。

删除过程还使用gitrm（自2013年10月git1.8.5起）。

总结

然后，三步移除过程将是：

0. mv a/submodule a/submodule_tmp

1. git submodule deinit -f -- a/submodule    
2. rm -rf .git/modules/a/submodule
3. git rm -f a/submodule
# Note: a/submodule (no trailing slash)

# or, if you want to leave it in your working tree and have done step 0
3.   git rm --cached a/submodule
3bis mv a/submodule_tmp a/submodule

解释

rm-rf：丹尼尔·施罗德的回答中提到了这一点，Eonil在评论中总结道：

这将使.git/modules/<子模块路径>/保持不变。所以，若您使用此方法删除了一个子模块并再次添加它们，那个么就不可能了，因为存储库已经损坏。

git rm：请参阅提交95c16418：

当前在子模块上使用“gitrm”会将子模块的工作树从超级项目的工作树中删除，并将gitlink从索引中删除。但是.gitmodules中的子模块部分保持不变，这是现在删除的子模块的剩余部分，可能会激怒用户（与.git/config中的设置相反，这必须保持提醒用户对该子模块感兴趣，以便稍后在签出旧的提交时重新填充）。

让“gitrm”不仅从工作树中删除子模块，还可以从.gitmodules文件中删除“submodule.<submodulename>”部分，并将两者都暂存，从而帮助用户。

git子模块deinit：它源于这个补丁：

使用“gitsubmodule init”，用户可以告诉git他们关心一个或多个子模块，并希望在下次调用“gitsubmodule update”时填充它。但目前，他们无法简单地告诉git他们不再关心子模块，并希望摆脱本地工作树（除非用户非常了解子模块的内部结构，并将“submodule.$name.url”设置与工作树一起从.git/config中删除）。

通过提供“deinit”命令帮助这些用户。这将删除整个子模块<对于给定的子模块（或所有已初始化的子模块，如果给定“.”）。如果当前工作树包含修改，则失败，除非强制。如果在命令行上给定的子模块的url设置在.git/config中找不到，但仍然不会失败，请进行投诉。

如果（de）初始化步骤（.git/config和.git/modules/xxx）

从git1.8.5开始，gitrm还负责：

在.gitmodules文件中记录子模块url的“add”步骤：需要为您删除它。子模块特殊条目（如这个问题所示）：gitrm将其从索引中删除：git rm—缓存的path_to_submodule（无尾斜杠）这将以特殊模式“160000”删除索引中存储的目录，并将其标记为子模块根目录。

如果您忘记了最后一步，并尝试将子模块添加为常规目录，则会收到如下错误消息：

git add mysubmodule/file.txt 
Path 'mysubmodule/file.txt' is in submodule 'mysubmodule'

注意：自从Git 2.17（2018年第二季度）以来，Git子模块deinit不再是shell脚本。这是对C函数的调用。

见Prathamesh Chavan（pratham pc）的承诺2e61273、承诺1342476（2018年1月14日）。（于2018年2月13日由Junio C Hamano--gitster--在commit ead8dbe中合并）

git ${wt_prefix:+-C "$wt_prefix"} submodule--helper deinit \
  ${GIT_QUIET:+--quiet} \
  ${prefix:+--prefix "$prefix"} \
  ${force:+--force} \
  ${deinit_all:+--all} "$@"

简单的步骤

删除配置项：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子模块吗？的答案？。

我刚刚找到了.submodule（忘记了确切名称）隐藏文件，它有一个列表。。。你可以用这种方式逐个删除它们。我刚刚有一个，所以我删除了它。很简单，但它可能会搞乱Git，因为我不知道子模块是否附加了什么。到目前为止，除了libetpan通常的升级问题外，似乎还可以，但这（希望）是无关的。

注意到没有人发布手动擦除，因此添加

如果你想删除子模块而不从本地文件系统中删除文件夹，我可以这样做：

MOD=example
git rm --cached -f apps/$MOD
git config -f .gitmodules --remove-section submodule.$MOD

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

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