如何维护支持多版本Newtonsoft.Json依赖的同一类库代码库

方案1：单SDK风格项目+条件化包引用（最优） #

直接使用SDK格式的项目文件，通过配置不同的生成条件关联对应版本的Newtonsoft.Json，无需拆分多个项目或使用链接文件，维护成本最低。
示例csproj配置：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
    <!-- 可根据实际需要调整支持的目标框架 -->
    <Configurations>Debug;Release;Debug_v10;Release_v10;Debug_v11;Release_v11;Debug_v12;Release_v12</Configurations>
  </PropertyGroup>

  <!-- 按生成配置匹配对应版本的依赖 -->
  <PropertyGroup>
    <NewtonsoftJsonVersion Condition="'$(Configuration.Contains(`v10`))'">10.0.1</NewtonsoftJsonVersion>
    <NewtonsoftJsonVersion Condition="'$(Configuration.Contains(`v11`))'">11.0.1</NewtonsoftJsonVersion>
    <NewtonsoftJsonVersion Condition="'$(Configuration.Contains(`v12`))'">12.0.1</NewtonsoftJsonVersion>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="$(NewtonsoftJsonVersion)" />
  </ItemGroup>
</Project>

优势：

• 所有源代码直接存放在该项目中，无需维护链接文件
• 切换Visual Studio顶部的生成配置即可编译对应依赖版本的类库
• 可配套为每个版本的配置单独建立单元测试项目，验证不同依赖版本下的功能正确性

方案2：优化现有链接文件方案 #

如果不想调整为SDK风格项目，可以把你原有结构中的「核心项目」改为无项目文件的公共源码目录，从根上解决核心项目依赖版本不确定的编译报错问题，调整后结构如下：

• 解决方案
  • 公共源码目录（仅存放.cs文件，无.csproj项目文件）
    • TestClass.cs
  • Project_v1 引用Newtonsoft.Json v10.0.1
    • TestClass.cs（通过添加为链接的方式引入自公共源码目录）
  • Project_v2 引用Newtonsoft.Json v11.0.1
    • TestClass.cs（通过添加为链接的方式引入自公共源码目录）
  • Project_v3 引用Newtonsoft.Json v12.0.1
    • TestClass.cs（通过添加为链接的方式引入自公共源码目录）
      修改后修改公共目录下的代码即可同步到所有版本项目，不会出现额外的编译错误。

方案3：单版本编译+Nuget版本范围声明（成本最低） #

因为你已经确认Newtonsoft.Json在10~12版本之间没有破坏性变更，完全可以只编译一份依赖最低版本（10.0.1）的类库，在发布Nuget包时声明依赖范围为[10.0.1, 13.0.0)，Nuget会自动匹配消费端已安装的符合范围的Newtonsoft.Json版本，运行时依赖高版本也能正常兼容，无需维护多份编译产物。

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