如何制作兼容多.NET框架版本且支持特性差异化的NuGet包？

不需要拆分多个独立的NuGet包，**多目标项目（Multi-targeting）**是更优雅的解决方案，能让单个NuGet包自动适配不同.NET版本，同时为高版本框架提供专属功能。

具体实现步骤： #

1. 配置项目多目标编译
   修改你的项目文件（.csproj），将单个TargetFramework替换为多个目标框架，比如同时支持.NET 6和.NET 7：

   <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
       <!-- 指定多个目标框架，用分号分隔 -->
       <TargetFrameworks>net6.0;net7.0</TargetFrameworks>
       <PackageId>MyStuff.Library</PackageId>
       <!-- 其他包配置：版本、作者等 -->
     </PropertyGroup>
   </Project>
   

2. 用条件编译包裹高版本专属代码
   使用.NET官方预定义的编译符号，将仅.NET 7可用的代码包裹起来。编译时，MSBuild会自动根据目标框架编译对应代码：

   public class YourIntegerType
   {
       private long IntegerValue;
   
       // 所有.NET版本都能使用的公共方法
       public long ToInt64(IFormatProvider? provider)
       {
           return IntegerValue;
       }
   
       // 仅.NET 7及以上版本可见的方法
       #if NET7_0_OR_GREATER
       public Int128 ToInt128(IFormatProvider? provider)
       {
           return (Int128)IntegerValue;
       }
       #endif
   }
   

   预定义符号如NET7_0_OR_GREATER是官方维护的，无需自行定义，涵盖了对应版本及更高的.NET框架。

3. 打包单个兼容多框架的NuGet包
   直接使用dotnet pack命令打包，MSBuild会为每个目标框架生成独立的程序集，并打包到同一个NuGet包中。使用者安装包时，NuGet会自动根据其项目的.NET版本匹配对应的程序集：

   • .NET 6项目：只能看到ToInt64方法，完全看不到ToInt128
   • .NET 7项目：可以正常使用两个方法

额外优化（可选） #

如果需要在低版本项目中明确提示该功能不可用，可以结合[EditorBrowsable]特性（需引用System.ComponentModel）：

#if NET7_0_OR_GREATER
[EditorBrowsable(EditorBrowsableState.Always)]
public Int128 ToInt128(IFormatProvider? provider)
{
    return (Int128)IntegerValue;
}
#else
[EditorBrowsable(EditorBrowsableState.Never)]
[Obsolete("此方法仅在.NET 7及以上版本可用", true)]
public void ToInt128(IFormatProvider? provider)
{
    throw new NotSupportedException();
}
#endif

这样低版本项目如果尝试调用该方法，编译器会直接报错，明确告知版本限制。

为什么不拆分多个NuGet包？ #

拆分多个包（如MyStuff.Library.6.0和MyStuff.Library.7.0）会带来诸多问题：

• 维护成本高：需要同步多个项目的代码、版本号和Bug修复
• 使用者体验差：必须手动根据自身.NET版本选择对应的包，容易选错
• 版本管理混乱：后续新增.NET版本时，需要重复创建新的包分支

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