Azure DevOps中Dotnet Pack生成的NuGet包缺失依赖问题

核心问题分析 #

你遇到的情况是dotnet pack没有自动将项目引用的Newtonsoft.Json加入NuGet包的依赖列表，这通常是项目配置或打包参数的问题，而非命令本身的逻辑缺陷。

解决方案步骤 #

1. 检查项目文件的包引用配置

打开ProjectThatNeedsJSON.csproj，确认Newtonsoft.Json的引用未被设置为私有资产：

<!-- 正确的包引用（无PrivateAssets限制） -->
<PackageReference Include="Newtonsoft.Json" Version="13.0.3" />

<!-- 错误示例：PrivateAssets会排除依赖，导致不被NuGet包包含 -->
<!-- <PackageReference Include="Newtonsoft.Json" Version="13.0.3" PrivateAssets="all" /> -->

如果存在PrivateAssets="all"或IncludeAssets="compile"这类限制，删除或调整这些属性，确保依赖能被NuGet工具正常检测到。

2. 指定打包配置为Release

默认dotnet pack使用Debug配置，部分项目在Debug模式下可能有特殊的依赖处理逻辑。修改流水线YAML，明确指定Release配置：

steps:
- task: DotNetCoreCLI@2
  displayName: 'dotnet pack'
  inputs:
    command: pack
    packagesToPack: GPIO/ProjectThatNeedsJSON.csproj
    arguments: '--configuration Release'

3. 确保项目启用包生成配置

在项目文件中添加或确认以下配置，保证打包时自动生成依赖信息：

<PropertyGroup>
  <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
  <PackageId>YourPackageId</PackageId>
  <PackageVersion>1.0.0</PackageVersion>
</PropertyGroup>

这些基础的NuGet元数据配置能帮助dotnet pack正确识别和生成依赖列表。

4. 验证打包结果（可选）

在流水线中添加验证步骤，确认生成的NuGet包包含正确的依赖：

- task: DotNetCoreCLI@2
  displayName: 'Check NuGet dependencies'
  inputs:
    command: custom
    custom: 'nuget'
    arguments: 'verify $(Build.ArtifactStagingDirectory)/**/*.nupkg -d'

这个命令会输出包的依赖信息，你可以在流水线日志中查看是否包含Newtonsoft.Json。

额外注意点 #

如果你的项目是.NET Framework（非.NET Core/.NET 5+），建议使用NuGetCommand@2任务而非DotNetCoreCLI@2，因为dotnet pack对旧框架的支持有限：

steps:
- task: NuGetCommand@2
  displayName: 'NuGet pack'
  inputs:
    command: pack
    packagesToPack: GPIO/ProjectThatNeedsJSON.csproj
    configuration: 'Release'

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