如何删除Git仓库树中误迁移的.git目录？

问题根源 #

原Subversion仓库中曾误提交MPC/.git目录，迁移到Git后该目录被纳入Git树结构。由于Git不允许工作目录中存在.git子目录（会与自身版本控制目录冲突），导致checkout该分支时触发无效路径错误。

解决方案（按推荐优先级排序） #

方法1：使用git filter-repo（官方推荐，高效安全）

git filter-repo是Git官方替代git filter-branch的工具，能批量修改提交历史，自动处理依赖关系：

• 克隆仓库的裸版本（避免checkout报错）：

  git clone --bare <你的仓库远程URL> repo-bare
  cd repo-bare
  

• 删除所有提交中的MPC/.git目录：

  git filter-repo --path MPC/.git --invert-paths
  

• 强制推送修复后的分支到远程：

  git push origin 2.3.4 --force
  

• 完成后，本地重新克隆或拉取该分支即可正常checkout。

方法2：使用git filter-branch（兼容旧版本Git）

如果无法使用git filter-repo，可尝试git filter-branch：

• 同样克隆裸仓库并进入：

  git clone --bare <你的仓库远程URL> repo-bare
  cd repo-bare
  

• 针对目标分支执行索引过滤，删除MPC/.git：

  git filter-branch --index-filter 'git rm -r --cached --ignore-unmatch MPC/.git' -- 2.3.4
  

• 强制推送更新：

  git push origin 2.3.4 --force
  

方法3：手动修改树对象（适合理解Git底层结构的场景）

对应你提到的mktree/write-tree/commit-tree组合命令，步骤如下：

1. 获取有问题分支的提交哈希：

   git rev-parse 2.3.4
   

   假设输出为BAD_COMMIT
2. 查看该提交对应的树对象哈希：

   git cat-file -p BAD_COMMIT
   

   找到tree字段对应的哈希BAD_TREE
3. 临时导出树对象并删除违规目录：

   mkdir temp-tree && cd temp-tree
   git read-tree BAD_TREE
   git rm -r --cached MPC/.git
   

4. 生成新的树对象：

   git write-tree
   

   得到新树哈希NEW_TREE
5. 创建新提交，复用原提交的元数据和信息：

   git commit-tree NEW_TREE -p BAD_COMMIT^ -m "$(git cat-file -p BAD_COMMIT | tail -n +5)"
   

   得到新提交哈希NEW_COMMIT
6. 更新分支指向新提交并推送：

   cd ..
   git update-ref refs/heads/2.3.4 NEW_COMMIT
   git push origin 2.3.4 --force
   

注意事项 #

• 强制推送会改写远程分支历史，需通知团队成员重新克隆仓库或执行git fetch origin && git reset --hard origin/2.3.4（确保本地未修改该分支）。
• 若目标分支之后有其他基于它的提交，git filter-repo和git filter-branch会自动调整后续提交的父节点，手动方法则需要逐个处理后续提交的依赖。

内容的提问来源于stack exchange，提问作者Nick Williams