Azure DevOps Pipeline中NuGet Restore无法找到Microsoft.Build.dll

针对Microsoft.Build.dll缺失问题 #

• 确认代理环境的VS组件完整性
  如果用微软托管代理，直接选择windows-latest或windows-2022镜像，这些镜像预装了完整的Visual Studio（包含MSBuild核心组件）；如果是自托管代理，打开VS安装器，确保勾选并安装了**“.NET桌面开发”工作负载**，这个负载会自动包含Microsoft.Build.dll。

• 强制NuGet使用指定的MSBuild路径
  在NuGet Restore任务中添加参数，明确指定MSBuild的安装路径，避免版本匹配错误：

  - task: NuGetCommand@2
    inputs:
      command: 'restore'
      restoreSolution: '**/*.sln'
      arguments: '-MSBuildPath "$(ProgramFiles)\Microsoft Visual Studio\2022\Enterprise\MSBuild\Current\Bin"'
  

  注意根据你的VS版本（2019/2022）和版本类型（Community/Professional/Enterprise）调整路径。

• 匹配NuGet与MSBuild版本
  不要盲目切换NuGet版本，按对应关系选择：

  • NuGet 6.x ↔ MSBuild 17.x（VS2022）
  • NuGet 5.x ↔ MSBuild 16.x（VS2019）
    可以在Pipeline中显式指定NuGet版本：

  - task: NuGetToolInstaller@1
    inputs:
      versionSpec: '6.4.x'
      checkLatest: true
  

针对偶尔找不到.sln文件的问题 #

• 先排查文件是否存在
  在Restore任务前添加脚本，查看当前工作目录的文件结构，确认sln文件是否在预期位置：

  - script: |
      dir /s
    displayName: 'List all files in working directory'
  

• 修正restoreSolution路径
  如果sln文件在子目录中，要使用通配符精准匹配，比如**/YourProject.sln，避免只写*.sln导致漏找。
• 确认代码仓库提交状态
  检查本地的sln文件是否已经推送到Azure Repos，有时候本地存在但未提交，会导致Pipeline中找不到文件。

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