Visual Studio输出目录生成冗余DLL：术语及直接解决方法

专业术语 #

你遇到的这种行为叫做传递依赖强制复制，本质是.NET Framework的程序集依赖解析机制结合NuGet包的依赖管理策略导致的：当程序集（如First.dll）通过项目引用或NuGet包间接依赖其他程序集（如Second.dll）时，构建系统会默认将所有传递依赖的程序集复制到输出目录，即便这些依赖并未被直接调用——尤其是替换.NET内置引用为NuGet包后，NuGet的依赖传递规则会覆盖传统项目引用的Copy Local设置优先级。

直接解决方法（无需构建后事件） #

1. 调整NuGet包的依赖资产范围 #

如果Second.dll是通过NuGet包引入的，在First项目的.csproj文件中修改对应的包引用配置，将传递依赖标记为私有资产，阻止其被复制到引用First的项目输出目录：

<PackageReference Include="YourSecondPackage" Version="x.x.x">
  <!-- 所有依赖资产仅保留在当前项目，不传递 -->
  <PrivateAssets>all</PrivateAssets>
  <!-- 或者仅排除运行时资产，保留编译时依赖 -->
  <!-- <ExcludeAssets>runtime</ExcludeAssets> -->
</PackageReference>

2. 拆分功能模块，隔离依赖 #

将First项目中依赖Second.dll的功能单独拆分到一个新的类库项目（如First.FeatureX.dll），让主First.dll不再直接依赖Second.dll。这样当其他项目仅引用First.dll时，不会触发Second.dll的传递复制；只有当需要使用依赖Second的功能时，才单独引用拆分后的模块。

3. 动态加载依赖程序集，移除静态引用 #

在First项目中移除对Second.dll的静态项目引用，改为仅在调用相关功能时动态加载该程序集：

• 在需要使用Second功能的代码中，通过Assembly.Load或Assembly.LoadFrom加载Second.dll：

  public void UseSecondFeature()
  {
      var secondAssembly = Assembly.LoadFrom("Second.dll");
      // 反射调用Second.dll中的类型或方法
  }
  

• 同时确保First项目的.csproj中不存在对Second的静态引用，彻底切断传递依赖链。

4. 转换为SDK风格项目（推荐） #

将.NET 4.8的类库项目转换为SDK格式项目（替代传统的旧项目格式），SDK风格项目对依赖复制的控制更精细，默认不会复制未被直接使用的传递依赖，还可以通过属性禁用传递项目引用：

1. 将项目文件内容替换为SDK格式模板：

   <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
       <TargetFramework>net48</TargetFramework>
       <!-- 禁用传递项目引用，仅复制直接引用的程序集 -->
       <DisableTransitiveProjectReferences>true</DisableTransitiveProjectReferences>
     </PropertyGroup>
   
     <!-- 原有的项目引用、NuGet包引用等 -->
   </Project>
   

2. 重新加载项目后，构建系统会自动调整依赖复制逻辑，仅复制当前项目直接使用的程序集。

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