DevOps Pipeline VSBuild任务无法找到已还原NuGet包导致构建失败

当前配置存在两个直接导致MSBuild无法识别NuGet包的错误：

• 手动指定的ReferencePath路径无效：NuGet还原包时会按照包名/版本号/lib/目标框架的层级存放程序集，你将引用路径直接指向packages根目录，MSBuild不会递归扫描子目录，根本无法定位下层的dll文件。
• 多余参数干扰依赖解析：你硬编码添加的/p:RestorePackagesConfig=true仅适配传统packages.config格式的项目，如果你使用的是SDK风格的PackageReference依赖模式，这个参数会直接打断正常的依赖查找逻辑；即便是packages.config项目，你自定义的还原目录和MSBuild默认查找的包路径也没有打通。

• 查看已添加的命令行任务输出的目录结构，确认NuGet包确实下载成功：比如DevExpress相关包的dll是否存在于packages/DevExpress.Web.ASPxThemes.v21.1/21.1.6/lib/对应.NET版本路径下，先排除包源权限不足、nuget.config配置错误导致包根本没下载到本地的问题。
• 打开本地项目的csproj文件，确认依赖是通过传统packages.config文件还是<PackageReference>节点管理，两种模式的流水线配置逻辑完全不同。
• 先删掉所有自定义的ReferencePath、RestorePackagesConfig参数跑一次构建，开启详细日志（msbuildArgs加/v:n）查看MSBuild搜索程序集的路径列表，和实际存包的位置做对比，就能直接定位路径偏差点。

根据项目依赖管理模式二选一即可：

场景1：传统.NET Framework项目，使用packages.config管理依赖 #

去掉硬编码的引用路径，还原步骤不要自定义还原目录，保持和本地Visual Studio默认行为一致：

trigger:
- dev

pool:
  vmImage: 'windows-latest'

variables:
  solution: 'WebAPI/myWebAPI/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

steps:
- task: NuGetToolInstaller@1
  inputs:
    versionSpec: '>=5.9.0'

- task: NuGetCommand@2
  inputs:
    command: 'restore'
    restoreSolution: '$(solution)'
    feedsToUse: 'config'
    nugetConfigPath: 'WebAPI/myWebAPI/myWebAPI/nuget.config'

- task: VSBuild@1
  inputs:
    solution: '$(solution)'
    platform: '$(buildPlatform)'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation="$(build.artifactStagingDirectory)" /v:n'
    configuration: '$(buildConfiguration)'
    restoreNugetPackages: false

注意：如果sln文件和nuget.config不在同一级目录，要确认nuget.config里的<repositoryPath>配置和仓库实际路径匹配，本地Visual Studio能正常构建是因为会自动识别解决方案级的配置，流水线中手动指定nugetConfigPath时不会自动做路径适配。

场景2：SDK风格项目，使用PackageReference管理依赖 #

不需要单独运行NuGet还原任务，直接开启VSBuild内置的还原功能即可，不需要手动指定任何包路径参数：

trigger:
- dev

pool:
  vmImage: 'windows-latest'

variables:
  solution: 'WebAPI/myWebAPI/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

steps:
- task: NuGetToolInstaller@1

- task: VSBuild@1
  inputs:
    solution: '$(solution)'
    platform: '$(buildPlatform)'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation="$(build.artifactStagingDirectory)" /v:n'
    configuration: '$(buildConfiguration)'
    restoreNugetPackages: true
    nugetConfigPath: 'WebAPI/myWebAPI/myWebAPI/nuget.config'

• 如果配置修改后依然找不到DevExpress这类商业组件包，先检查nuget.config中配置的私有源权限，确认流水线运行身份有权限拉取对应包，避免出现本地有缓存包可以正常构建、流水线因为权限不足拉不到包的情况。
• 非必要不要手动指定packages还原目录，如果一定要自定义还原路径，ReferencePath不能只写根目录，需要写通配符匹配所有子目录的框架路径，例如/p:ReferencePath="$(Build.SourcesDirectory)/WebAPI/myWebAPI/packages/**/lib/net48/"，但这种写法维护成本极高，升级框架或包版本时需要同步修改路径，不推荐使用。

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