如何克隆Git仓库指定文件夹并映射到本地不同路径？

方法一：稀疏检出+目录重映射（支持提交推送） #

这个办法能拉取远程的Folder1并映射到本地根目录，而且可以正常提交推送，唯一的小缺点是本地.git会带整个仓库的元数据，但体积可以通过后续清理优化。

具体操作：

1. 先建本地文件夹并初始化仓库：

   mkdir Folder1 && cd Folder1
   git init
   git remote add origin <你的远程仓库地址>
   

2. 开启稀疏检出，只拉取Folder1的内容：

   git config core.sparseCheckout true
   echo "Folder1/*" >> .git/info/sparse-checkout
   

3. 拉取远程主分支（比如main）：

   git pull origin main
   

4. 把远程Folder1的内容映射到本地根目录：
   先找Folder1对应的tree哈希值：

   git ls-tree origin main:Folder1
   # 会输出类似 0a1b2c3d... Folder1 这样的内容，前面的哈希就是我们要的
   

   然后用git replace把当前HEAD的根目录替换成这个tree：

   git replace --graft HEAD <刚才拿到的Folder1 tree哈希>
   

   执行完你会发现本地根目录直接出现p1.py和p2.py了。
5. 提交推送：
   之后修改文件直接提交就行，推送的内容会自动回到远程的Folder1目录下：

   git add .
   git commit -m "更新p1.py逻辑"
   git push origin main:main
   

方法二：独立分支+克隆（满足.git仅含Folder1内容，推荐） #

如果一定要本地.git只存Folder1的相关内容，最稳妥的方式是给远程仓库的Folder1单独建一个分支，然后直接克隆这个分支。

第一步：在远程仓库创建Folder1的独立分支 #

去远程仓库所在的机器或者平台上执行（比如GitHub可以在网页上操作，或者本地连远程仓库执行）：

# 切到一个全新的孤儿分支，没有任何历史
git checkout --orphan folder1-branch
# 删除当前分支下所有内容
git rm -rf .
# 从main分支把Folder1的内容拿过来
git checkout main -- Folder1/*
# 把Folder1里的文件移到根目录，删掉空的Folder1
mv Folder1/* . && rm -rf Folder1
# 提交并推送到远程
git add .
git commit -m "初始化folder1分支，包含原Folder1的所有内容"
git push origin folder1-branch

第二步：本地克隆这个独立分支 #

git clone -b folder1-branch <你的远程仓库地址> Folder1

这样本地Folder1就是个完全独立的仓库，.git里只有这个分支的内容，提交推送都直接作用于这个分支。如果需要和原main分支的Folder1同步，写个简单脚本或者手动合并就行。

方法三：Git过滤器（适合只读场景） #

如果只是需要拉取内容，不需要推送，用过滤器映射路径也可以：

1. 初始化本地仓库并配置过滤器：

   mkdir Folder1 && cd Folder1
   git init
   git remote add origin <你的远程仓库地址>
   # 配置clean过滤器：提交时给路径加回Folder1/；smudge过滤器：拉取时去掉Folder1/
   git config filter.folder1.clean "sed 's/^/Folder1\/'"
   git config filter.folder1.smudge "sed 's/^Folder1\///'"
   

2. 创建.gitattributes让所有文件应用这个过滤器：

   echo "* filter=folder1" >> .gitattributes
   

3. 拉取远程内容：

   git pull origin main
   

   拉完本地根目录就有p1.py和p2.py了，但这个方法推送容易出冲突，只建议只读用。

内容的提问来源于stack exchange，提问作者Dr. Gut