从Git历史彻底移除子模块目录，BFG Repo Cleaner是否适用？

先给你吃个定心丸：BFG Repo Cleaner完全可以处理你这种情况——也就是那种因为目录自带.git文件夹，被Git误识别为子模块（日志显示Subproject commit xxx），但你并没有通过git submodule add正式添加的“伪子模块”。本质上这种子模块在Git历史里只是以提交哈希引用+目录树对象的形式存在，BFG的目录清理能力完全覆盖这种场景。

具体操作步骤 #

• 第一步：务必备份仓库！因为改写Git历史是不可逆操作，提前复制一份仓库副本，避免意外丢失数据。
• 第二步：获取BFG的jar包后，执行以下命令清理目标目录（把dir-name换成你要移除的目录名）：

  java -jar bfg.jar --delete-folders dir-name your-repo.git
  

  这个命令会遍历仓库的所有历史提交，把包含该子模块目录的所有痕迹（包括子模块的提交引用、对应目录树）全部移除。
• 第三步：执行Git的收尾清理，彻底清除废弃的对象：

  cd your-repo.git
  git reflog expire --expire=now --all && git gc --prune=now --aggressive
  

• 第四步：强制推送到远程仓库（注意：如果有其他协作者，一定要提前通知他们，因为历史被改写后，他们的本地仓库需要重新克隆，不能直接拉取）：

  git push --force
  

额外注意事项 #

• 如果是正式通过git submodule add添加的子模块（仓库里有.gitmodules文件记录），BFG同样能删除目录，但你可能还需要清理.gitmodules里的相关配置。可以额外加上--delete-files .gitmodules参数让BFG处理，或者清理完目录后手动修改.gitmodules再提交。
• 执行完所有操作后，你可以用git log --all --oneline | grep "Subproject"检查历史，确认子模块的提交记录已经被彻底移除。

内容的提问来源于stack exchange，提问作者Gibezynu Nu