Git稀疏检出指定子目录失败：为何获取了多余子目录？

问题场景 #

我的Git仓库结构如下：

= dir 1
 -- subdir1
 -- subdir2

= dir 2

希望仅克隆dir2和dir1/subdir1目录，但执行以下命令后，却拉取了包含subdir1和subdir2的完整dir1目录：

mkdir ${projectName} &&
cd ${projectName} &&
git init &&
git remote add -f origin <url> &&
git config core.sparseCheckout true &&
echo "dir2" >> .git/info/sparse-checkout &&
git config core.sparseCheckout false &&
echo "dir1/subdir1" >> .git/info/sparse-checkout &&
git pull origin main &&
git config core.sparseCheckout false

错误分析 #

1. 过早关闭稀疏检出功能
   在添加dir2到稀疏检出列表后，执行git config core.sparseCheckout false直接关闭了稀疏检出，后续添加dir1/subdir1的规则根本不会生效，Git默认拉取整个仓库内容。

2. 稀疏检出规则匹配逻辑误解
   即使正确开启稀疏检出，Git默认的cone模式下，dir1/subdir1会被识别为前缀匹配（匹配dir1/下的所有内容），导致整个dir1目录被拉取，而非仅subdir1。

修正后的命令方案 #

方案一：利用规则优先级（兼容所有Git版本） #

mkdir ${projectName} &&
cd ${projectName} &&
git init &&
git remote add -f origin <url> &&
# 开启稀疏检出
git config core.sparseCheckout true &&
# 添加需要保留的目录
echo "dir2/" >> .git/info/sparse-checkout &&
# 先包含dir1父目录，再排除不需要的subdir2
echo "dir1/" >> .git/info/sparse-checkout &&
echo "!dir1/subdir2/" >> .git/info/sparse-checkout &&
# 拉取远程main分支
git pull origin main

方案二：精确匹配（Git 2.25+版本推荐） #

关闭默认的cone模式，启用精确通配符匹配：

mkdir ${projectName} &&
cd ${projectName} &&
git init &&
git remote add -f origin <url> &&
git config core.sparseCheckout true &&
# 关闭cone模式，支持精确路径匹配
git config core.sparseCheckoutCone false &&
# 精确指定需要的目标目录
echo "dir2/" >> .git/info/sparse-checkout &&
echo "dir1/subdir1/" >> .git/info/sparse-checkout &&
git pull origin main

说明 #

• 方案一通过"先包含父目录，再排除不需要的子目录"的规则优先级实现精准拉取，兼容所有Git版本。
• 方案二关闭cone模式后，Git支持精确路径匹配，直接指定目标子目录即可，逻辑更直观。

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