如何使用Git从GitHub克隆子目录并指定目标路径？

问题描述 #

我希望通过Git从GitHub仓库下载一个文件夹，并将其添加到本地仓库的指定子目录，即本地路径为repo/folder/subfolder/clonedfolder（clonedfolder为从GitHub克隆的文件夹）。但实际克隆后会带上多余的路径，变成repo/folder/subfolder/folder/folder1/folder2/clonedfolder，这并非我想要的结果。我已尝试以下操作：

repo/folder/subfolder$ git init

repo/folder/subfolder$ git remote add -f origin git@github.com:repo/repo.git

repo/folder/subfolder$ git sparse-checkout init

repo/folder/subfolder$ git sparse-checkout set clonedfolder

repo/folder/subfolder$ git sparse-checkout list
- clonedfolder

repo/folder/subfolder$ git pull origin develop

请问Git是否支持实现我的需求？

解决方案 #

Git完全支持你的需求，当前问题源于稀疏检出默认会保留远程仓库的完整目录结构。你可以根据场景选择以下两种方法：

方法1：直接下载指定目录（推荐，无需关联本地仓库） #

这种方式不需要在本地初始化Git仓库，直接将远程目标文件夹下载到指定路径：

1. 进入本地目标目录：

cd repo/folder/subfolder

2. 执行下载命令（替换远程仓库中clonedfolder的实际完整路径folder/folder1/folder2/clonedfolder）：

mkdir -p clonedfolder
git archive --remote=git@github.com:repo/repo.git develop:folder/folder1/folder2/clonedfolder | tar -x -C clonedfolder

• --remote：指定远程仓库的SSH地址
• develop:xxx：明确要下载的分支和目标文件夹的完整路径
• tar -x -C clonedfolder：将解压后的内容直接放入新建的clonedfolder目录，避免多余路径

方法2：稀疏检出后调整目录（适合需关联远程仓库的场景） #

如果需要本地仓库与远程保持同步关联，可以先拉取原结构的文件夹，再调整目录：

1. 完成你之前的初始化与拉取步骤：

repo/folder/subfolder$ git init
repo/folder/subfolder$ git remote add -f origin git@github.com:repo/repo.git
repo/folder/subfolder$ git sparse-checkout init
repo/folder/subfolder$ git sparse-checkout set "folder/folder1/folder2/clonedfolder"
repo/folder/subfolder$ git pull origin develop

2. 移动文件夹到目标路径并清理多余目录：

repo/folder/subfolder$ mv folder/folder1/folder2/clonedfolder ./
repo/folder/subfolder$ rm -rf folder/

3. 提交目录修改并更新稀疏检出配置：

repo/folder/subfolder$ git add .
repo/folder/subfolder$ git commit -m "Move clonedfolder to target path"
repo/folder/subfolder$ git sparse-checkout set clonedfolder

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