.NET Framework项目添加NuGet包信息时出现无关加载错误

关于你遇到的VS项目属性报错 #

你碰到的 System.ArgumentException: Expected 1 values for property Build::DefineConstants, but got 0 错误，本质是传统.NET Framework项目的.csproj格式不兼容你在Rider中添加的部分NuGet相关属性。这类属性Rider能正常解析，但VS对传统csproj的属性解析规则更严格，导致读取项目属性时出错。解决方向有两个：要么把项目转为SDK风格的.NET Framework项目（同时兼容VS和Rider），要么改用.nuspec文件定义NuGet包信息。

1. 符合规范的NuGet程序集信息应放置在何处？ #

分两类场景处理：

• 程序集元数据（版本、作者、版权等）：
  • 传统非SDK风格的.NET Framework项目：放在项目根目录Properties文件夹下的AssemblyInfo.cs中，通过[AssemblyVersion]、[AssemblyCompany]等特性定义。
  • SDK风格项目（包括.NET Framework 4.8的SDK风格）：可以直接在.csproj中用<Version>、<Authors>等属性定义，这些属性会自动覆盖AssemblyInfo.cs中的对应值（也可以禁用自动生成AssemblyInfo，保留手动维护的文件）。
• NuGet包专属信息（包ID、描述、依赖项、打包规则等）：
  • SDK风格项目：直接写在.csproj里即可，VS和Rider都能正常识别。
  • 传统非SDK风格项目：建议写在.nuspec文件中，避免出现你遇到的VS兼容问题。

2. 创建.NET Framework项目的NuGet包是否需要.nuspec文件？什么是NuGet-Spec文件？为何需要它？ #

• NuGet-Spec文件就是.nuspec：这是一个XML格式的配置文件，用来定义NuGet包的所有核心信息，包括包ID、版本、作者、依赖项、要包含的文件、发布说明等。
• 是否需要分情况：
  • 如果是SDK风格的.NET Framework 4.8项目：不需要.nuspec，直接通过.csproj配置打包属性，用dotnet pack命令就能生成包，VS和Rider都支持这种方式。
  • 如果是传统非SDK风格的.NET Framework项目：不是必须，但非常推荐。因为传统csproj对NuGet属性的支持有限，手动添加属性容易触发VS兼容问题（比如你碰到的报错）；另外如果需要精细控制打包内容（比如包含项目外的配置文件、文档，或者自定义不同框架的依赖组），.nuspec能提供更灵活的配置能力。
• 为什么需要它：.nuspec是NuGet早期就有的标准配置方式，对于非SDK项目是最稳妥的打包配置方案，能完全脱离项目文件独立定义包的结构和元数据，避免IDE之间的兼容问题。

3. .NET NuGet包与.NET Framework NuGet包有何区别？ #

这里的“.NET”指.NET 5及以后的统一平台（包括.NET Core），和.NET Framework的包主要区别在这几点：

• 目标框架标识不同：.NET Framework包的目标框架用net48、net472这类标识；.NET包用net6.0、net7.0、net8.0等，还支持跨平台的目标框架（比如net6.0-windows）。
• 打包结构差异：
  • .NET Framework传统包通常包含lib文件夹（按框架版本存放程序集）、tools（存放工具脚本）、content（安装时会复制到项目中的文件）等目录。
  • .NET包基于SDK风格，结构更简洁，用contentFiles替代旧的content，依赖项通过项目文件自动推导，多目标框架打包更简便。
• 依赖管理逻辑：
  • .NET Framework包的依赖通常基于.NET Framework版本，部分依赖可能指向系统GAC中的程序集。
  • .NET包的依赖更灵活，支持框架依赖部署（FDD）和独立部署（SCD），依赖项会自动适配目标框架版本。
• 兼容性：.NET包无法直接在.NET Framework项目中引用（除非包特意做了多目标兼容），反之.NET Framework包也不能直接在.NET 5+项目中使用，除非包兼容对应的框架。
• 打包工具：.NET包用dotnet pack命令；.NET Framework传统包通常用nuget pack命令（可基于.csproj或.nuspec）。

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