.NET项目如何为不同版本的同名依赖设置引用别名

你可以通过.NET内置的**外部别名（extern alias）**功能实现需求，具体操作步骤如下：

步骤1：修改项目文件给v2.0 SDK配置别名 #

编辑MyWorkProject.csproj项目文件，找到新增的v2.0版本SomeCompaniesSdk.csproj的引用节点，添加Aliases属性配置别名，原有v1.0的引用保持不变即可：

<!-- 原有v1.0版本SDK引用，无需修改 -->
<ProjectReference Include="..\v1_0\SomeCompaniesSdk.csproj" />

<!-- 新增v2.0版本SDK引用，添加Aliases属性指定别名 -->
<ProjectReference Include="..\v2_0\SomeCompaniesSdk.csproj">
  <Aliases>SomeCompaniesSdkv2</Aliases>
</ProjectReference>

步骤2：在代码中使用别名调用v2.0 SDK #

在需要用到v2.0 SDK的MyWorker2.cs文件最顶部（所有其他代码、using语句之前）声明外部别名，之后就可以正常引用新版SDK：

// 外部别名声明必须放在文件最顶部
extern alias SomeCompaniesSdkv2;

// 可以直接通过别名引入新版SDK的命名空间
using SomeCompaniesSdkv2;

public class MyWorker2
{
    public void DoWork()
    {
        // 调用v2.0版本的SdkClient
        var v2SdkClient = new SdkClient();
        
        // 也可以用别名限定符明确区分版本，避免冲突
        var explicitV2Client = new SomeCompaniesSdkv2::SomeCompaniesSdk.SdkClient();
        // 原有v1.0版本的SdkClient可以正常调用，不受影响
        var v1SdkClient = new SomeCompaniesSdk.SdkClient();
    }
}

注意事项 #

• 每个需要使用v2.0 SDK的代码文件，都需要在文件最顶部添加extern alias SomeCompaniesSdkv2;声明
• 如果你后续是引用Nuget包而不是项目引用，别名配置方式一致，给PackageReference节点添加<Aliases>SomeCompaniesSdkv2</Aliases>子节点即可

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