支持多版本.NET Core共存的自定义NuGet包升级兼容性咨询

核心问题结论 #

直接发布仅面向.NET 6的单目标框架NuGet包后，运行在.NET Core 3.1上的项目升级该新版包后无法正常构建。

原因说明 #

NuGet存在严格的目标框架适配校验规则：.NET Core 3.1项目仅可兼容目标框架低于/等于.NET Core 3.1，或同时包含.NET Core 3.1适配实现的多目标框架包。仅包含.NET 6实现的NuGet包被.NET Core 3.1项目引用时，会直接触发框架不兼容错误，阻断构建流程。

推荐处理方案 #

• 优先采用多目标框架打包方案
  在类库的项目文件（.csproj）中，将单框架配置TargetFramework替换为多框架配置：

  <TargetFrameworks>netcoreapp3.1;net6.0</TargetFrameworks>
  

  重新打包后生成的NuGet会同时包含两个框架的适配实现，既可以支持.NET 6新项目使用，也可以兼容原有.NET Core 3.1项目正常升级引用。你已确认无破坏性代码变更，该方案几乎没有额外改造成本。
• 若确定放弃.NET Core 3.1支持，需做版本隔离
  可以将最后一个支持.NET Core 3.1的包版本作为1.x分支维护，面向.NET 6的升级包从2.0.0开始发布，同时在包说明中明确标注「2.x及以上版本仅支持.NET 6及更高版本框架」，告知原有.NET Core 3.1用户不要跨大版本升级包。
• 上线前校验
  发布前可分别新建.NET Core 3.1和.NET 6的测试项目，引用新生成的NuGet包执行构建、基础功能校验，避免隐含的依赖丢失问题。

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