使用VSTS构建NuGet包异常：包内无项目DLL仅含完整项目

我之前也踩过这个坑！这种情况大概率是NuGet打包的配置逻辑出了问题，导致工具误把项目源文件当成内容打包，而非编译后的目标DLL。下面是几个靠谱的排查和解决方向：

• 检查自定义NuSpec文件的配置
  如果你的项目里手动编写了.nuspec文件，一定要确认<files>节点的配置是否正确指向了编译产物，而不是整个项目文件。举个正确的配置例子：

  <files>
    <file src="bin\Release\YourProject.dll" target="lib\netstandard2.0" />
    <file src="bin\Release\YourProject.pdb" target="lib\netstandard2.0" />
  </files>
  

  要是你不小心写了<file src="**\*.*" target="content" />这类通配符，就会把所有项目源文件都打包成内容文件，自然看不到预期的DLL。

• 确认VSTS打包任务的模式选择
  在VSTS的NuGet打包任务里，选对模式很关键：

  • 如果你用的是SDK风格项目（比如.NET Core/.NET 5+），优先选择“使用dotnet pack”或者直接执行dotnet pack命令，SDK会自动帮你处理DLL的打包逻辑，不用手动写nuspec。
  • 对于传统.NET Framework项目，要确保打包任务指定了正确的构建输出目录，并且勾选了“包含构建输出”相关选项，别误选成直接打包项目文件。

• 检查项目文件的属性设置
  针对SDK风格项目，确认项目文件里没有错误的<Content>或<Pack>配置。比如如果某个DLL被标记为<Content Include="YourProject.dll" />，它就会被当成内容文件而非库文件打包。推荐让SDK自动处理，或者在项目文件里明确添加：

  <PropertyGroup>
    <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
  </PropertyGroup>
  

  这样构建时会自动生成包含DLL的NuGet包。

• 清理缓存后重新构建
  VSTS的构建缓存有时候会残留旧的错误产物，建议在打包任务前添加“清理工作目录”的步骤，或者用dotnet build --clean先清理再执行dotnet pack，避免旧文件干扰。

额外提醒：如果用传统NuGet.exe打包，一定要针对编译后的输出目录执行命令，别直接对着项目根目录打包，否则很容易把源文件全塞进去。

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