如何让.NET 8与.NET Framework 4.8共享WinForms类库？

一、先解决project.assets.json错误 #

• 执行dotnet restore命令，或者在Visual Studio里右键项目选择「还原NuGet包」，确保两个框架的依赖都被正确恢复。
• 若仍报错，检查项目文件配置，确保没有遗漏必要属性。

二、正确的多目标项目配置 #

修改类库项目文件（.csproj）为以下内容，覆盖所有必要配置：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net8.0-windows;net48</TargetFrameworks>
    <UseWindowsForms>true</UseWindowsForms>
    <!-- .NET Framework专属配置 -->
    <TargetFrameworkProfile Condition="'$(TargetFramework)' == 'net48'"></TargetFrameworkProfile>
    <OutputType Condition="'$(TargetFramework)' == 'net48'">Library</OutputType>
  </PropertyGroup>

  <!-- .NET Framework必要引用 -->
  <ItemGroup Condition="'$(TargetFramework)' == 'net48'">
    <Reference Include="System.Windows.Forms" />
    <Reference Include="System.Drawing" />
  </ItemGroup>
</Project>

三、共享窗体文件，避免手动复制 #

无需维护两个独立项目，直接在多目标项目中统一管理窗体文件：

• 新建窗体/控件时，Visual Studio会自动将其包含到所有目标框架的编译列表中。
• 已有窗体文件需确保项目文件里的<Compile>和<EmbeddedResource>条目无单框架限制，示例：

<ItemGroup>
  <Compile Update="MySharedForm.cs">
    <SubType>Form</SubType>
  </Compile>
  <EmbeddedResource Update="MySharedForm.resx">
    <DependentUpon>MySharedForm.cs</DependentUpon>
  </EmbeddedResource>
</ItemGroup>

四、处理API兼容性差异 #

针对两个框架的WinForms API差异，用条件编译指令区分实现：

#if NET48
// .NET Framework 4.8专属代码
using System.Drawing;
#else
// .NET 8专属代码
using System.Drawing.Common;
#endif

public class MySharedForm : Form
{
    public MySharedForm()
    {
#if NET48
        Icon = new Icon("legacy-icon.ico");
#else
        Icon = Icon.ExtractAssociatedIcon("modern-icon.ico");
#endif
    }
}

五、验证步骤 #

1. 保存项目文件后执行dotnet restore。
2. 在Visual Studio的解决方案平台下拉菜单中，分别切换到.NET 8.0 Windows和.NET Framework 4.8，编译项目。
3. 将类库引用到对应框架的项目中，测试窗体功能是否正常运行。

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