Git稀疏克隆后如何仅推送指定子目录至GitHub仓库

问题核心：稀疏克隆仅控制本地检出的文件范围，但Git仓库的提交历史仍包含整个大型项目的所有内容，直接推送会把完整仓库同步到你的远程仓库。要实现只推送sub3/subsub1并将其设为目标仓库根目录，需要重构仓库历史或拆分目录，以下是两种可行方案：

方案一：用git filter-repo重构仓库（推荐） #

这个工具会彻底清理仓库历史，只保留与sub3/subsub1相关的提交，并将该目录内容移至根目录：

1. 确保已安装git filter-repo（可通过pip install git-filter-repo安装，部分Git版本已内置）
2. 回到本地仓库根目录：

   cd %the repository directory%
   

3. 执行重构命令，保留目标目录并调整为根目录：

   git filter-repo --path sub3/subsub1 --path-rename sub3/subsub1:/
   

4. 此时本地仓库根目录就是原sub3/subsub1的内容，历史仅保留该目录的相关提交
5. 推送至你的GitHub仓库（注意-f强制推送，因为重构了历史）：

   git push -f myorigin %branch%
   

方案二：用git subtree拆分目录推送 #

适合需要保留原仓库关联、不想修改本地历史的场景：

1. 回到本地仓库根目录：

   cd %the repository directory%
   

2. 将sub3/subsub1目录拆分到新分支：

   git subtree split --prefix sub3/subsub1 -b subsub1-branch
   

3. 推送新分支到你的远程仓库：

   git push myorigin subsub1-branch:%branch%
   

   推送完成后，你的GitHub仓库根目录就是原sub3/subsub1的内容

注意事项 #

• 方案一重构历史后，本地仓库将与原大型仓库失去历史关联，若需同步原仓库更新，建议单独维护一个克隆仓库，再将修改同步到你的仓库
• 方案二的新分支仅包含目标目录的历史，后续从原仓库拉取更新后，可再次执行subtree split合并新修改

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