如何加深Git浅克隆历史至指定路径的最新提交？

为什么git clone -n --depth=1找不到目标路径？ #

-n（--no-checkout）只是让克隆后不生成工作区文件，核心问题和它的关联不大。真正的原因是：浅克隆（--depth=1）仅拉取仓库默认分支的最新提交快照，但如果Git在浅克隆过程中没有完整获取目标路径对应的树对象或Blob对象，就会导致git checkout无法识别该路径。

你提到不带-n时路径能正常检出，是因为不带-n的克隆会自动执行检出操作，这个过程会触发Git拉取该路径所需的所有对象；而带-n时，克隆仅完成了提交和树对象的拉取，未触发Blob对象的获取，因此执行git checkout时会报错。

无需提前查提交，如何加深浅克隆到指定路径的最新提交？ #

有两种高效的方法可以解决这个问题：

方法1：通过git fetch加深克隆深度 #

1. 先创建带-n的浅克隆：

git clone -v --depth=1 -n github:macports/macports-ports mptree-git

2. 进入仓库目录：

cd mptree-git

3. 执行以下命令，让Git自动获取目标路径的最新提交及所需对象：

git fetch origin --depth=1 :/security/KeePassXC

这个命令会告诉远程仓库，我们需要获取security/KeePassXC路径的最新提交对应的历史，Git会自动加深克隆深度至包含该路径的最新提交。
4. 最后检出目标路径：

git checkout HEAD security/KeePassXC

方法2：使用稀疏检出（更适合大型仓库） #

稀疏检出是Git专门为获取大型仓库中少量文件设计的功能，比浅克隆更高效：

1. 创建仅包含仓库元数据的空克隆：

git clone --no-checkout --filter=blob:none github:macports/macports-ports mptree-git
cd mptree-git

2. 启用稀疏检出模式：

git sparse-checkout init --cone

3. 添加需要获取的目标路径：

git sparse-checkout add security/KeePassXC

4. 拉取指定路径的内容：

git pull origin main

执行后，本地只会生成security/KeePassXC路径下的文件，无需拉取整个仓库的内容。

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