Azure DevOps发布Nuget包时额外上传多余依赖包问题咨询

现象定性 #

该现象不属于预期行为，本质是流水线的Nuget推送步骤匹配逻辑、打包参数存在浮动性，导致误匹配到本地缓存的所有依赖包进行上传。

核心触发原因 #

• 你使用的Nuget推送任务（不管是经典界面的NuGet push还是YAML的DotNetCoreCLI@2 push命令）如果指定的待推送文件路径是**/*.nupkg且没有设置排除规则，会把全局Nuget缓存目录、还原后生成在bin目录下的所有依赖nupkg都匹配到，一并推送
• 如果流水线使用公共共享代理节点，偶尔会出现构建环境缓存未清理的情况，导致之前还原的依赖nupkg遗留在工作目录，被推送规则命中
• 如果打包时开启了IncludeSymbols参数，或者没有指定--no-dependencies参数，部分版本的dotnet SDK会把依赖包也一并生成到输出目录

解决方案 #

1. 调整推送路径的匹配规则，避免命中依赖包 #

不要使用宽泛的递归匹配规则**/*.nupkg，指定只匹配项目输出目录下的nupkg，示例YAML配置：

- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    # 仅匹配打包指定输出目录下的nupkg，避免命中缓存文件
    packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg'
    nuGetFeedType: 'internal'
    publishVstsFeed: '<你的制品源ID>'

如果使用NuGet.exe执行推送，同样不要使用递归匹配：

nuget push *.nupkg -Source <你的源地址> -ApiKey <认证密钥>

2. 打包时添加参数限制依赖输出，强制依赖内置 #

在dotnet pack命令中添加参数，将所有依赖打包进单个nupkg，同时不生成单独的依赖包：

- task: DotNetCoreCLI@2
  inputs:
    command: 'pack'
    packagesToPack: '**/*.csproj'
    versioningScheme: 'off'
    # 关键参数：所有依赖内置，不单独输出依赖包
    arguments: '--property:IncludeAssets=runtime --property:PrivateAssets=all --no-dependencies'
    # 指定固定的打包输出目录，避免和其他文件混放
    outputDir: '$(Build.ArtifactStagingDirectory)'

也可以直接在.csproj文件中配置，避免每次打包都传参数：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <!-- 强制所有依赖内置，不生成分离的依赖包引用 -->
    <IncludeAssets>runtime</IncludeAssets>
    <PrivateAssets>all</PrivateAssets>
    <!-- .NET 5+版本如果需要生成单文件包，可添加该配置 -->
    <PublishSingleFile>true</PublishSingleFile>
  </PropertyGroup>
</Project>

3. 流水线构建前清理工作目录，避免缓存文件干扰 #

在YAML开头添加工作目录清理配置，确保每次构建都是干净环境：

jobs:
- job: Build
  workspace:
    clean: all # 清理整个工作目录的历史残留文件
  steps:
    # 后续的还原、构建、打包、推送步骤

也可以在还原步骤前单独添加清理命令：

- task: DotNetCoreCLI@2
  inputs:
    command: 'clean'
    projects: '**/*.csproj'

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