如何配置Visual Studio 2022解决方案同时编译.NET 4.8与.NET 7版本

背景问题 #

• 现有基于.NET Framework 4.8的VB.NET大型类库（包含数千个类、数百万行代码），原用VS2019开发，已升级至VS2022
• 使用Upgrade Assistant直接升级到.NET 7时出现大量编译错误，精简核心代码后虽能编译，但存在两大问题：缺失原项目大量功能代码、原项目更新后需手动同步代码，单人维护难度极高
• 目标：创建单个VS2022项目，可同时编译生成.NET 4.8和.NET 7版本的DLL，通过条件编译处理跨框架兼容问题，逐步迁移代码后弃用原.NET Framework项目

一、创建多目标类库项目 #

• 打开VS2022，创建**VB.NET 类库（.NET）**项目（初始选择.NET 7框架）
• 右键项目→选择「编辑项目文件」（打开.vbproj文件），开始配置多目标参数

二、配置多目标框架 #

在项目文件的<Project>节点下，找到原有的<TargetFramework>节点，替换为<TargetFrameworks>并同时指定两个目标框架：

<TargetFrameworks>net48;net7.0</TargetFrameworks>

注：框架顺序不影响编译，可将日常调试优先的框架放在前面

三、配置分版本输出目录 #

为避免不同框架的编译产物相互覆盖，在项目文件中添加输出目录配置，让不同版本的DLL输出到各自子目录：

<PropertyGroup>
  <!-- 基础输出根目录 -->
  <BaseOutputPath>bin\$(Configuration)\</BaseOutputPath>
  <!-- 为每个目标框架设置独立输出子目录 -->
  <OutputPath>$(BaseOutputPath)$(TargetFramework)\</OutputPath>
  <IntermediateOutputPath>obj\$(Configuration)\$(TargetFramework)\</IntermediateOutputPath>
</PropertyGroup>

四、配置条件编译符号 #

为不同框架添加专属编译符号，方便在VB.NET代码中区分处理兼容逻辑：

<PropertyGroup Condition="'$(TargetFramework)' == 'net48'">
  <DefineConstants>NET48;$(DefineConstants)</DefineConstants>
</PropertyGroup>
<PropertyGroup Condition="'$(TargetFramework)' == 'net7.0'">
  <DefineConstants>NET7_0;$(DefineConstants)</DefineConstants>
</PropertyGroup>

VB.NET中编译符号不区分大小写，建议统一使用大写格式

五、VB.NET代码中的条件编译示例 #

在代码中使用#If...#Else...#End If块处理跨框架不兼容的逻辑：

' 通用兼容代码，两个框架均会编译
Public Function GetLibraryVersion() As String
    Return "2.0.0"
End Function

' 仅在.NET Framework 4.8下编译的代码
#If NET48 Then
Imports System.Web
Public Function GetAspNetRuntimeVersion() As String
    Return HttpRuntime.Version.ToString()
End Function
#End If

' 仅在.NET 7下编译的代码
#If NET7_0 Then
Imports System.Text.Json
Public Function SerializeToJson(obj As Object) As String
    Return JsonSerializer.Serialize(obj)
End Function
#End If

六、依赖包适配 #

若项目使用NuGet包，需确保包支持两个目标框架，或为不同框架指定适配的包版本：

<ItemGroup Condition="'$(TargetFramework)' == 'net48'">
  <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
</ItemGroup>
<ItemGroup Condition="'$(TargetFramework)' == 'net7.0'">
  <PackageReference Include="System.Text.Json" Version="7.0.3" />
</ItemGroup>

七、迁移与维护建议 #

• 优先迁移通用核心代码，确保两个框架均能正常编译
• 对每个不兼容代码块，添加条件编译分支，逐步替换为跨框架兼容的API（如使用.NET Standard兼容的替代方案）
• 利用VS2022多目标调试功能：右键项目→属性→调试，选择对应目标框架启动调试
• 待所有代码适配完成后，即可删除原.NET Framework 4.8项目，仅维护该多目标项目

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