.NET 6中如何引用同一NuGet包的两个版本并设置别名

步骤1：修改项目文件配置别名 #

首先需要在项目的.csproj文件中，给目标DLL（dll2）指定别名，dll1保持默认引用即可。

直接引用本地DLL的场景

<ItemGroup>
  <!-- 引用dll1，不设置别名，默认全局访问 -->
  <Reference Include="dll1">
    <HintPath>你的dll1路径/dll1.dll</HintPath>
  </Reference>
  <!-- 给dll2设置别名`Alias` -->
  <Reference Include="dll2">
    <HintPath>你的dll2路径/dll2.dll</HintPath>
    <Aliases>Alias</Aliases>
  </Reference>
</ItemGroup>

引用NuGet包的场景

如果dll2来自NuGet包，需要同时设置PrivateAssets避免传递依赖：

<ItemGroup>
  <!-- dll1对应的NuGet包，默认引用 -->
  <PackageReference Include="Package1" Version="对应版本号" />
  <!-- 给dll2的NuGet包设置别名 -->
  <PackageReference Include="Package2" Version="对应版本号">
    <Aliases>Alias</Aliases>
    <PrivateAssets>all</PrivateAssets>
  </PackageReference>
</ItemGroup>

步骤2：在代码中声明别名引用 #

在需要使用dll2类型的代码文件顶部，添加extern alias声明，注意要放在所有using语句之前：

extern alias Alias;

步骤3：分别调用两个DLL的类型 #

现在就可以在不同命名空间的方法中，分别访问两个DLL的同名类型：

namespace1中调用dll1的类型

namespace namespace1
{
    public class OperationHandler1
    {
        public void DoOperationFirstWay()
        {
            // 直接访问dll1中的LoadedLib.Type1，无需前缀
            var typeInstance = new LoadedLib.Type1();
            // 执行后续操作
        }
    }
}

namespace2中调用dll2的类型

extern alias Alias;

namespace namespace2
{
    public class OperationHandler2
    {
        public void DoOperationSecondWay()
        {
            // 通过别名`Alias::`前缀访问dll2中的LoadedLib.Type1
            var typeInstance = new Alias::LoadedLib.Type1();
            // 执行后续操作
        }
    }
}

注意事项 #

• extern alias需要在每个使用dll2类型的代码文件顶部单独声明
• 确保两个DLL的运行时版本兼容，避免出现类型加载冲突
• 若项目是ASP.NET Core、控制台应用等不同类型，配置方式完全一致，只需修改对应的.csproj文件即可

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