Git稀疏检出子文件夹时如何修改默认目录结构至仓库指定位置？

问题背景 #

远程Git仓库目录结构如下：

|_Folder1
|_Folder2
        |_ SubFolder2
                    |_ SubSubFolder2

需要在Windows系统的C:\MyRepo仓库内，通过Git稀疏检出SubFolder2（包含其下的SubSubFolder2），并移除上级的Folder2目录，最终目标结构：

C:\MyRepo
        |_ SubFolder2
                    |_ SubSubFolder2

使用常规稀疏检出命令：

git clone --no-checkout --sparse <remoteRepoURL> "C:\MyRepo"
cd /d "C:\MyRepo"
git sparse-checkout set "Folder2/SubFolder2/SubSubFolder2"
git checkout

得到的仍是原始目录结构，无法去掉Folder2，询问是否有方法实现需求，还是Git稀疏检出必须保留原始目录结构。

可行解决方案 #

Git原生稀疏检出默认会保留远程仓库的目录结构，但可以通过以下两种方式实现目录结构修改：

方法1：本地移动目录并更新Git索引（适合需与远程同步的场景） #

这种方式不修改仓库历史，仅调整本地工作区和索引，后续拉取远程更新后可能需要重复调整：

1. 克隆并稀疏检出目标目录：

git clone --no-checkout <remoteRepoURL> "C:\MyRepo"
cd /d "C:\MyRepo"
git sparse-checkout init --cone
git sparse-checkout set "Folder2/SubFolder2/*"
git checkout

2. 移动目录并更新Git跟踪：

# 将SubFolder2移动到仓库根目录
move "Folder2/SubFolder2" .
# 删除空的Folder2目录
rmdir "Folder2"
# 移除Git对旧路径的跟踪，添加新路径
git rm --cached "Folder2/SubFolder2"
git add "SubFolder2"
# 提交本地修改（仅本地生效，不影响远程）
git commit -m "Move SubFolder2 to root directory"

方法2：使用git filter-repo重写本地仓库（适合仅本地使用的场景） #

git filter-repo是Git官方推荐的历史重写工具，可彻底将目标目录映射到根目录，修改后本地历史与远程不一致，不建议推送回远程：

1. 确保已安装git filter-repo（Windows可通过Chocolatey或官方二进制包安装）。

2. 克隆仓库并执行目录重写：

git clone <remoteRepoURL> "C:\MyRepo"
cd /d "C:\MyRepo"
# 将Folder2/SubFolder2下的所有内容移动到根目录
git filter-repo --path-rename Folder2/SubFolder2/:

结论 #

Git原生稀疏检出确实会保留原始目录结构，但通过本地调整索引+移动目录或**git filter-repo重写仓库**可以实现需求。前者适合需要保持与远程同步的场景，后者适合仅本地使用、无需推送修改回远程的场景。

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