Visual Studio中NuGet Pack命令未打包正确DLL的问题排查

• 使用Visual Studio 2022 Community，按官方步骤对解决方案内某一目标项目（共3个项目）执行NuGet打包：右键目标项目选择「Pack」后构建正常，但生成的NuGet包中包含的是同解决方案内另一项目的DLL，而非控制台输出的目标DLL，所有项目的DLL输出到同一目录。
• 同时收到两条NU5128警告，内容如下：

NuGet.Build.Tasks.Pack.targets(221,5): warning NU5128: Some target frameworks declared
in the dependencies group of the nuspec and the lib/ref folder do not have exact matches
in the other location. Consult the list of actions below:

NuGet.Build.Tasks.Pack.targets(221,5): warning NU5128: - Add lib or ref assemblies for
the net7.0 target framework

一、解决NuGet包打包错误DLL的问题 #

1. 检查项目打包属性
   • 右键目标项目 → 「属性」→ 「打包」选项卡：
     • 确认「包 ID」为当前项目的唯一ID，而非其他项目的ID；
     • 检查「输出路径」，避免多个项目共用同一输出目录（默认路径为bin\$(Configuration)\$(TargetFramework)，若手动修改为统一路径，容易导致DLL被覆盖），建议改回默认路径或给每个项目设置独立输出子目录。
2. 清理残留文件后重新构建
   • 执行「生成」→ 「清理解决方案」，手动删除所有项目的bin和obj目录；
   • 先重新构建整个解决方案，再单独对目标项目执行「Pack」操作，避免旧编译文件残留导致打包错误。
3. 检查自定义nuspec文件（若存在）
   • 若项目根目录有手动创建的.nuspec文件，打开检查<files>节点是否指定了错误的DLL路径，修正为当前项目的输出路径，示例：

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

   • 若无自定义nuspec，确认「打包」选项卡中「包含生成的项目文件」处于勾选状态，确保自动生成的临时nuspec关联当前项目。
4. 排查项目输出目录覆盖问题
   • 打开目标项目的输出目录，确认是否存在其他项目的DLL（若存在，说明输出路径冲突导致文件被覆盖），调整各项目的输出路径为独立目录即可。

二、解决NU5128警告 #

该警告源于nuspec中声明的目标框架（net7.0）与lib/ref目录下的程序集框架不匹配，可按以下步骤修复：

1. 确认项目目标框架一致性
   • 右键目标项目 → 「属性」→ 「应用程序」选项卡，确认「目标框架」为net7.0，与警告中的框架一致。
2. 检查打包设置的目标框架
   • 在「打包」选项卡的「目标框架」列表中，确保包含net7.0，若未添加则手动添加。
3. 修正自定义nuspec的框架配置（若存在）
   • 若使用自定义nuspec，确保<dependencies>节点中声明的框架与项目目标框架一致，同时在<files>节点中将DLL指定到对应框架的lib子目录（如lib\net7.0）。
4. 禁用自动依赖文件生成（可选）
   • 若不需要自动生成依赖组，可在项目的.csproj文件中添加以下配置，避免nuspec出现不匹配的框架声明：

     <PropertyGroup>
       <GenerateDependencyFile>false</GenerateDependencyFile>
     </PropertyGroup>
     

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