如何用Azure DevOps SDK for .NET下载Git仓库Zip文件并本地保存？

一、修改现有代码保存Zip文件 #

你的现有代码中，GetItemAsync当download: true时返回的是HttpResponseMessage，包含了文件的流内容。需要修正异步调用方式（避免用.Result阻塞线程），然后将响应流写入本地文件：

public async Task DownloadItemAsync(string gitRepositoryName, string remoteFilePath, string localFilePath)
{
    VssConnection vssConnection = GetVssConnection();
    GitHttpClient gitHttpClient = vssConnection.GetClient<GitHttpClient>();

    // 使用await替代.Result，避免线程阻塞和死锁
    using var response = await gitHttpClient.GetItemAsync(
        Settings.TfsProjectName, 
        gitRepositoryName, 
        remoteFilePath, 
        recursionLevel: VersionControlRecursionType.Full, // 若要下载文件夹下所有内容，需设为Full；单个文件用None
        download: true);

    // 确保请求成功
    response.EnsureSuccessStatusCode();

    // 将响应内容写入本地文件
    using var fileStream = new FileStream(localFilePath, FileMode.Create, FileAccess.Write);
    await response.Content.CopyToAsync(fileStream);
}

二、推荐更合适的专用方法：GetItemsZipAsync #

Azure DevOps SDK提供了GetItemsZipAsync方法，专门用于将Git仓库指定路径的内容打包为Zip文件下载，比GetItemAsync更贴合场景，参数更明确：

public async Task DownloadItemsAsZipAsync(string gitRepositoryName, string remotePath, string localZipPath)
{
    VssConnection vssConnection = GetVssConnection();
    GitHttpClient gitHttpClient = vssConnection.GetClient<GitHttpClient>();

    // 指定版本信息（示例为main分支，可替换为标签、提交ID等）
    var versionDescriptor = new GitVersionDescriptor 
    { 
        VersionType = GitVersionType.Branch, 
        Version = "main" 
    };

    // 获取Zip格式的流
    using var zipStream = await gitHttpClient.GetItemsZipAsync(
        project: Settings.TfsProjectName,
        repositoryId: gitRepositoryName,
        path: remotePath,
        recursionLevel: VersionControlRecursionType.Full, // 控制是否递归下载子目录
        versionDescriptor: versionDescriptor);

    // 将Zip流写入本地文件
    using var fileStream = new FileStream(localZipPath, FileMode.Create, FileAccess.Write);
    await zipStream.CopyToAsync(fileStream);
}

关键注意事项 #

• 始终使用await处理异步方法，避免用.Result或.Wait()，防止线程阻塞和死锁。
• 使用using语句包裹流和HttpResponseMessage，确保资源被正确释放。
• recursionLevel参数需根据需求设置：VersionControlRecursionType.None仅下载指定路径的单个文件，VersionControlRecursionType.Full递归下载所有子目录内容。
• GitVersionDescriptor可灵活指定下载的版本（分支、标签、提交哈希等），适配不同场景。

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