如何让共享项目适配不同NuGet包版本，供两个API引用？

场景回顾 #

• 现有架构：Legacy API、New API、Shared项目均基于net6.0（C#10），统一使用某NuGet包v1
• 需求：Legacy API保留v1，New API升级至NuGet包v2，Shared项目需同时兼容两个API
• 当前方案问题：复制Shared项目生成V1/V2两个.csproj，不符合MSBuild规范且易造成文件混淆

最优方案：单项目+MSBuild条件属性控制 #

无需复制项目文件，通过MSBuild属性传递，让Shared项目根据引用方的需求自动切换NuGet版本和编译逻辑。

1. 修改Shared项目.csproj #

添加可被引用方覆盖的条件属性，动态控制NuGet包版本和编译常量：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <LangVersion>10.0</LangVersion>
    <!-- 默认配置：适配NuGet v1 -->
    <NuGetPackageVersion>1.0.0</NuGetPackageVersion>
    <DefineConstants>$(DefineConstants);V1</DefineConstants>
  </PropertyGroup>

  <!-- 条件引用NuGet包，版本由属性控制 -->
  <ItemGroup>
    <PackageReference Include="YourNuGetPackageName" Version="$(NuGetPackageVersion)" />
  </ItemGroup>
</Project>

2. 配置Legacy API的项目引用 #

保持默认配置，直接引用Shared项目即可自动使用NuGet v1：

<ProjectReference Include="..\Shared\Shared.csproj" />

3. 配置New API的项目引用 #

通过Properties节点覆盖Shared项目的属性，指定使用NuGet v2并定义V2编译常量：

<ProjectReference Include="..\Shared\Shared.csproj">
  <Properties>
    <NuGetPackageVersion>2.0.0</NuGetPackageVersion>
    <DefineConstants>$(DefineConstants);V2</DefineConstants>
  </Properties>
</ProjectReference>

4. 调整Shared项目的代码逻辑 #

根据编译常量区分不同NuGet版本的实现：

#if V1
// 适配NuGet v1的业务逻辑
public void ProcessData(DataV1 data)
{
    // v1版本的处理逻辑
}
#elif V2
// 适配NuGet v2的业务逻辑
public void ProcessData(DataV2 data)
{
    // v2版本的处理逻辑
}
#endif

方案优势 #

• 无冗余文件：仅维护一个Shared项目，避免重复.csproj带来的混淆
• 符合MSBuild规范：通过标准的属性传递机制实现版本控制，而非自定义的项目复制
• 编译隔离：两个API引用Shared时会生成各自适配的程序集，运行时无冲突
• 扩展性强：后续新增NuGet版本时，只需添加对应编译常量和逻辑即可

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