如何用脚本拉取VSTS Git develop分支指定文件夹？稀疏检出报错求助

你遇到的"Sparse checkout leaves no entry on the working directory"错误，核心原因基本是指定的文件夹路径和远程仓库实际路径不匹配，或者稀疏检出的配置步骤有细节疏漏。下面是经过验证的PowerShell和批处理方案，包含完整的身份验证和路径配置说明：

PowerShell 脚本方案 #

# 1. 创建并切换到本地目标目录（替换成你想要的路径）
$localPath = "C:\Your\Local\Target\sql"
New-Item -Path $localPath -ItemType Directory -Force
Set-Location -Path $localPath

# 2. 初始化本地Git仓库
git init

# 3. 添加远程仓库地址（用你提供的仓库URL）
$repoUrl = "https://phm-dsc.visualstudio.com/PHM/_git/repo"
git remote add origin $repoUrl

# 4. 启用稀疏检出功能
git config core.sparseCheckout true

# 5. 配置要拉取的文件夹路径（重点！必须和远程仓库里的路径完全一致）
# 举个例子：如果远程仓库里的目标文件夹是`/src/database/sql`，就写下面这行
# 末尾加/**是为了拉取文件夹下的所有内容，避免只拉空文件夹
"src/database/sql/**" | Out-File -FilePath .git/info/sparse-checkout -Encoding utf8

# 6. 拉取develop分支
# 如果是私有仓库，拉取时会弹出验证窗口，输入Azure DevOps账号+PAT即可；也可以把PAT嵌入URL：https://<你的PAT>@phm-dsc.visualstudio.com/PHM/_git/repo
git pull origin develop

批处理脚本方案 #

@echo off
setlocal enabledelayedexpansion

:: 1. 创建并切换到本地目标目录
set "localPath=C:\Your\Local\Target\sql"
if not exist "%localPath%" mkdir "%localPath%"
cd /d "%localPath%"

:: 2. 初始化本地Git仓库
git init

:: 3. 添加远程仓库地址
set "repoUrl=https://phm-dsc.visualstudio.com/PHM/_git/repo"
git remote add origin %repoUrl%

:: 4. 启用稀疏检出
git config core.sparseCheckout true

:: 5. 配置要拉取的文件夹路径（路径必须和远程完全匹配）
echo src/database/sql/** > .git/info/sparse-checkout

:: 6. 拉取develop分支
git pull origin develop

必看注意事项 #

1. 路径一定要精准匹配：你可以登录Azure DevOps仓库页面，找到目标文件夹，复制它的完整路径（比如在文件夹页面的地址栏里能看到路径）。路径末尾加/**是关键，这样能确保拉取文件夹下的所有文件和子文件夹，避免只拉空目录导致报错。
2. 身份验证问题：如果仓库是私有库，拉取时需要验证身份。最方便的是用个人访问令牌（PAT），在Azure DevOps的个人设置里生成，权限选「Code Read」就行。要么在弹出的登录窗口输入账号+PAT，要么把PAT直接嵌入仓库URL：https://<你的PAT>@phm-dsc.visualstudio.com/PHM/_git/repo。
3. 编码问题：PowerShell里用Out-File时一定要加-Encoding utf8，不然稀疏检出的配置文件可能出现编码错误，导致Git识别不了路径。

如果还是有问题，可以先执行git fetch origin develop，然后检查.git/info/sparse-checkout文件的内容是否正确，或者尝试先git checkout develop再拉取，确保分支切换正确。

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