这种场景我之前帮团队处理过，**多目标框架（Multi-targeting）**就是完美的解决方案——完全不需要复制代码文件，只通过改造项目文件就能让同一套CS代码同时编译到.NET Framework 4.6.1和.NET Core 2.0，既能满足迁移需求，又能保证遗留项目的依赖引用，彻底解决维护难题。

核心思路 #

利用.NET Core的SDK-style项目格式（取代旧的.NET Framework项目格式），在单个.csproj中指定多个目标框架，让同一套代码编译出适配不同框架的输出。同时通过条件引用、预处理指令处理框架差异，实现代码共享。

具体实现步骤 #

1. 改造项目为多目标SDK-style项目 #

将原有.NET Framework项目的旧.csproj替换为SDK-style格式，指定TargetFrameworks为net461;netcoreapp2.0（注意用分号分隔多个框架）。

示例.csproj代码：

<Project Sdk="Microsoft.NET.Sdk">
  <!-- 指定同时编译到.NET Framework 4.6.1和.NET Core 2.0 -->
  <PropertyGroup>
    <TargetFrameworks>net461;netcoreapp2.0</TargetFrameworks>
    <!-- 可选：设置输出目录，区分不同框架的编译结果 -->
    <OutputPath>bin\$(TargetFramework)\</OutputPath>
  </PropertyGroup>

  <!-- 针对不同框架的条件依赖引用 -->
  <ItemGroup Condition="'$(TargetFramework)' == 'net461'">
    <!-- .NET Framework专属的程序集引用 -->
    <Reference Include="System.Web" />
    <!-- 旧项目原有的NuGet包引用也可以放在这里 -->
    <PackageReference Include="OldNetFrameworkPackage" Version="x.x.x" />
  </ItemGroup>

  <ItemGroup Condition="'$(TargetFramework)' == 'netcoreapp2.0'">
    <!-- .NET Core专属的NuGet包引用 -->
    <PackageReference Include="Microsoft.AspNetCore.App" Version="2.0.0" />
  </ItemGroup>

  <!-- 共享所有现有代码文件，无需复制 -->
  <ItemGroup>
    <Compile Include="**\*.cs" />
    <!-- 如果代码在其他目录，用相对路径引用 -->
    <!-- <Compile Include="..\SharedProjects\**\*.cs" /> -->
  </ItemGroup>
</Project>

2. 处理代码中的框架差异 #

如果代码中有框架专属的API，用预处理指令区分不同框架的逻辑，避免编译错误：

// 根据目标框架引入不同的命名空间
#if NET461
using System.Web;
#elif NETCOREAPP2_0
using Microsoft.AspNetCore.Http;
#endif

public class UserService
{
    public string GetUserAgent(object context)
    {
        #if NET461
            // .NET Framework下的逻辑
            var httpContext = (HttpContext)context;
            return httpContext.Request.UserAgent;
        #else
            // .NET Core下的逻辑
            var httpContext = (Microsoft.AspNetCore.Http.HttpContext)context;
            return httpContext.Request.Headers["User-Agent"].ToString();
        #endif
    }
}

3. 让遗留项目引用多目标项目 #

• 解决方案内引用：直接在遗留.NET Framework 4.6.1项目中添加对多目标项目的引用，Visual Studio会自动识别并引用net461版本的编译输出，无需额外配置。
• 外部引用：可以将多目标项目打包成NuGet包，遗留项目通过NuGet安装，NuGet会自动匹配对应框架的版本。

4. 批量处理上百个项目的技巧 #

手动修改上百个项目效率太低，可以用PowerShell脚本批量生成/替换.csproj文件：

# 遍历当前目录下所有子目录中的旧.csproj
Get-ChildItem -Recurse -Filter *.csproj | ForEach-Object {
    # 读取旧项目的代码文件引用（可选，根据实际情况调整）
    $oldContent = Get-Content $_.FullName
    $compileFiles = $oldContent | Select-String '<Compile Include="(.*)"' | ForEach-Object { $_.Matches.Groups[1].Value }

    # 生成新的SDK-style多目标项目内容
    $newContent = @"
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net461;netcoreapp2.0</TargetFrameworks>
  </PropertyGroup>
  <ItemGroup>
    $(foreach ($file in $compileFiles) { "<Compile Include=`"$file`" />`n    " })
  </ItemGroup>
</Project>
"@

    # 替换旧项目文件
    Set-Content $_.FullName $newContent
}

Visual Studio中的便捷操作 #

• 切换目标框架：在解决方案资源管理器中，右键多目标项目 → 属性 → 应用程序，可以看到已勾选的目标框架，也可以直接编辑.csproj添加更多框架。
• 查看框架专属内容：在代码编辑器的右上角，选择对应的目标框架，VS会自动隐藏当前框架不兼容的代码，方便调试。

注意事项 #

• 优先使用**.NET Standard库**封装共享逻辑：如果部分代码可以抽象为跨框架的通用逻辑，建议单独创建.NET Standard 2.0项目（兼容.NET Framework 4.6.1和.NET Core 2.0），减少预处理指令的使用。
• 验证第三方依赖兼容性：确保项目引用的第三方包同时支持.NET Framework 4.6.1和.NET Core 2.0，否则需要用条件引用替换为对应框架的包。
• 测试双框架编译：每次修改代码后，同时编译两个框架的版本，避免出现单框架编译通过但另一个框架报错的情况。

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