如何使用Git命令删除仓库中旧的untracked文件夹？

问题根源 #

./project/folder曾是submodule，即使现在显示为untracked文件，普通git clean命令也删不掉——因为文件夹里残留了原submodule的.git子目录，Git默认不会递归删除包含独立Git仓库的文件夹，防止误操作。

解决步骤 #

1. 清理submodule残留配置 #

先彻底移除仓库里关于这个废弃submodule的配置：

• 打开.gitmodules文件，找到对应project/folder的条目，直接删除（如果存在）
• 执行命令清除Git配置中的submodule记录：

  git config --remove-section submodule.project.folder
  

• 若修改了.gitmodules，提交变更：

  git add .gitmodules
  git commit -m "移除废弃的project/folder submodule配置"
  

2. 用Git命令删除目标文件夹 #

因为文件夹内有残留的Git仓库，需要分两步清理：

# 先清理文件夹内的.git目录
git clean -fdx -- ./project/folder/.git
# 再删除整个folder文件夹
git clean -fdx -- ./project/folder

备选方案（若曾被Git追踪） #

如果这个文件夹之前作为submodule被Git追踪过，也可以用以下命令：

git rm --cached ./project/folder
git clean -fdx

--cached会取消Git对该路径的追踪，之后git clean就能正常删除文件夹了。

验证 #

执行完命令后，运行git status确认./project/folder不再出现在untracked文件列表中，且文件夹已被删除。

内容的提问来源于stack exchange，提问作者Alexy Khilaev