.NET 6升级WinForm项目时TargetFrameworks多目标框架的疑问

问题背景 #

我们正将Windows Forms项目从.NET Framework 4.5升级至.NET 6，由于WinForm的诸多API在.NET 6中已被弃用，我将某WinForm项目的TargetFramework配置从：

<PropertyGroup><TargetFramework>net6.0-windows</TargetFramework></PropertyGroup>

修改为：

<PropertyGroup><TargetFrameworks>net45;net6.0-windows</TargetFrameworks></PropertyGroup>

修改后出现错误：

Project <another_project> targets 'net6.0-windows'. It cannot be referenced by a project that targets '.NETFramework,Version=v4.7.2'.

已知该错误原因是WinForm项目引用的<another_project>目标框架为.NET 6，可将其也改为包含.NET 4.5的多目标框架，但存在以下疑问：

• 设置多TargetFrameworks是否意味着项目未完全升级至.NET 6？
• 在.NET 6构建失败的场景下会自动用.NET45编译吗？
• TargetFrameworks的具体工作机制是怎样的？

解答 #

1. 多TargetFrameworks是否意味着项目未完全升级至.NET 6？ #

不是。多目标框架是过渡阶段的兼容方案，本质是让项目同时支持两个框架：

• 你依然可以针对.NET 6编写新代码、使用.NET 6的特性，只是保留了对.NET Framework 4.5的兼容能力
• 完全升级到.NET 6的标志是移除.NET Framework相关的目标框架，只保留net6.0-windows，但多目标是升级过程中处理API弃用、依赖兼容的常用手段，不代表升级未完成。

2. .NET 6构建失败会自动用.NET45编译吗？ #

不会。多目标框架的构建是独立执行的：

• 当你构建项目时，MSBuild会针对TargetFrameworks列表中的每个框架分别执行完整的构建流程
• 如果其中某一个框架（比如.NET 6）构建失败，整个构建任务会失败，不会自动 fallback 到另一个框架。你需要修复对应框架的构建错误，或者手动指定只构建某一个框架（比如用dotnet build -f net45）。

3. TargetFrameworks的具体工作机制 #

多目标框架的核心是MSBuild针对每个目标框架生成独立的构建上下文：

• 独立的编译环境：每个目标框架会使用对应版本的编译器、类库和API集。比如针对net45编译时，会引用.NET Framework 4.5的类库；针对net6.0-windows时，引用.NET 6的Windows专属类库。
• 条件编译支持：你可以通过预编译指令区分不同框架的代码，比如：

  #if NET45
      // .NET Framework 4.5专属代码
  #elif NET6_0_WINDOWS
      // .NET 6 Windows专属代码
  #endif
  

• 依赖处理：每个目标框架可以有独立的依赖配置，比如在项目文件中用Condition指定：

  <PackageReference Include="Newtonsoft.Json" Version="12.0.3" Condition="'$(TargetFramework)' == 'net45'" />
  <PackageReference Include="Newtonsoft.Json" Version="13.0.3" Condition="'$(TargetFramework)' == 'net6.0-windows'" />
  

• 输出产物独立：构建完成后，每个目标框架的编译产物会放在各自的子目录（比如bin/Debug/net45和bin/Debug/net6.0-windows），互不干扰。

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