Azure Pipeline如何配置多packages.lock.json的NuGet包缓存

多项目场景下NuGet缓存运行逻辑 #

• 官方文档给出的单packages.lock.json配置方案，核心逻辑是通过锁文件内容计算缓存唯一键：只要锁文件依赖信息不变，就直接拉取之前存储的NuGet全局包目录内容，跳过重复的包拉取流程。
• 每个项目独立持有packages.lock.json的多项目解决方案，缓存逻辑和单项目没有本质差异，核心要求是必须将所有项目的锁文件都纳入缓存键的计算范围——任意一个项目的依赖版本变动，都会触发缓存自动更新，不会出现依赖版本和锁文件不匹配的构建错误。
• 缓存存储的目标路径始终是当前构建代理上的NuGet全局包文件夹，和解决方案下的项目数量、锁文件数量无关，不需要按项目拆分独立缓存块。

可直接复用的配置步骤 #

• 前置检查：确认所有使用PackageReference格式的项目都已开启锁文件生成，在对应项目的.csproj文件中添加配置<RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>，本地执行一次dotnet restore后，将生成的所有packages.lock.json提交到代码仓库。
• 配置缓存任务：在NuGet还原任务之前添加Cache v2任务，缓存键使用通配符匹配所有项目下的锁文件，不要写死单文件路径，参考配置如下：

- task: Cache@2
  displayName: 恢复NuGet包缓存
  inputs:
    key: 'nuget | "$(Agent.OS)" | **/packages.lock.json'
    restoreKeys: |
      nuget | "$(Agent.OS)"
    path: '$(NUGET_PACKAGES)'
    cacheHitVar: 'NUGET_CACHE_HIT'

• 配置还原任务跳过逻辑：给后续的DotNet/NuGet还原任务添加判断条件，缓存命中时直接跳过还原步骤，参考配置如下：

- task: DotNetCoreCLI@2
  displayName: 还原项目依赖
  condition: ne(variables.NUGET_CACHE_HIT, 'true')
  inputs:
    command: 'restore'
    feedsToUse: 'config'
    nugetConfigPath: './NuGet.Config' # 替换为你自己的NuGet配置路径

常见配置踩坑 #

• 不要为每个项目单独配置独立缓存：所有项目拉取的NuGet包默认都会存到同一个全局包目录，拆分缓存只会增加存储占用、降低缓存命中率，没有任何收益。
• 如果解决方案中存在使用packages.config管理依赖的旧项目，把缓存键的匹配规则调整为**/packages.lock.json, **/packages.config即可兼容，不需要单独拆分配置。
• 不要把obj目录下的project.assets.json等临时生成文件纳入缓存，这类文件和构建代理路径、项目本地配置强绑定，缓存后反而会触发构建错误。

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