如何在保留目录结构的前提下拆分多子项目Git仓库为独立仓库？

操作核心错误 #

你执行git filter-repo时，未指定将子目录提升为新仓库根目录的关键参数，导致过滤后仅保留了project1文件夹，但该文件夹仍作为新仓库的子目录存在，而非直接成为根目录。另外，直接克隆原仓库到project1文件夹的操作完全多余，还会造成目录结构混乱。

针对project1的正确操作步骤 #

1. 先完整备份bigfolder仓库（避免操作失误丢失历史数据）
2. 进入bigfolder目录，克隆一份原仓库到临时目录（用于处理过滤，不影响原仓库）：

   git clone . ../temp-project1
   cd ../temp-project1
   

3. 使用git filter-repo提取project1目录并将其设为新仓库根目录：

   git filter-repo --subdirectory-filter project1
   

   执行后，临时仓库的根目录会直接是原project1内的内容（subfolder1、subfolder2直接处于根层级）
4. 回到原bigfolder/project1目录，清理现有内容后同步临时仓库的处理结果：

   cd ../../bigfolder/project1
   rm -rf * .gitignore  # 按需保留必要文件，或直接清空目录
   cp -r ../../temp-project1/* .
   cp -r ../../temp-project1/.git .
   

5. 验证拆分结果：

   git log  # 确认仅保留project1相关的提交历史
   git status  # 检查文件结构是否符合预期
   

project2的处理方式 #

重复上述步骤，将所有project1替换为project2即可完成第二个子项目的拆分。

额外注意事项 #

• 若本地无git filter-repo工具，需先通过包管理器或官方渠道安装（部分Git版本默认不包含该工具）
• 操作前务必备份原仓库，避免不可逆的数据丢失
• 所有子项目拆分完成后，原bigfolder/.git可按需删除（若不再需要原仓库）

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