升级被.NET Framework 4.X项目引用的类库到.NET Standard 2.1的兼容问题

核心原因 #

.NET Standard 2.1 不支持任何版本的 .NET Framework，.NET Framework 4.5 最高仅兼容 .NET Standard 1.1，这是出现引用报错的根本原因。

方案1（优先推荐）：类库配置多目标框架 #

该方案不需要修改13个现有 .NET Framework 4.5 项目的任何代码，同时可以保留类库对 .NET Standard 2.1 的支持，供后续升级的 .NET Core/.NET 5+ 项目使用。

• 打开类库的 .csproj 文件，将单目标配置的 <TargetFramework>netstandard2.1</TargetFramework> 改为多目标配置：

<TargetFrameworks>netstandard2.1;net45</TargetFrameworks>

注意标签为复数形式 TargetFrameworks，两个目标版本用分号分隔。

• 如果类库中存在两个目标框架下API不兼容的代码，使用预处理指令区分逻辑即可：

#if NET45
    // 仅在 .NET Framework 4.5 版本下执行的代码
#else
    // 仅在 .NET Standard 2.1 版本下执行的代码
#endif

• 重新编译类库后，所有项目都可以正常引用：.NET Framework 4.5 项目会自动匹配 net45 版本的编译产物，新的 .NET Core/.NET 5+ 项目会自动匹配 netstandard2.1 版本的产物。

方案2：降级类库到 .NET Standard 1.1 并修复依赖问题 #

如果你不需要类库支持 .NET Standard 2.1 的新特性，可以选择降级，针对遇到的 [DataContract] 相关报错，按以下步骤修复：

• 移除所有手动添加的旧版 dll 引用，所有依赖统一通过 Nuget 安装，避免版本冲突。
• 除了 System.Runtime.Serialization.Primitives 外，额外安装 System.Runtime.Serialization.Xml Nuget 包，覆盖序列化相关的全部API依赖。
• 检查类库中使用的其他API，确认是否有 .NET Standard 1.1 不支持的内容，如有则替换为兼容API，或用预处理指令做兼容处理。

方案3（备选，不推荐长期使用）：维护类库的两个版本 #

临时拆分类库为两个分支：一个保留原 .NET Framework 4.5 版本供现有13个项目引用，另一个升级为 .NET Standard 2.1 供已升级的新项目使用，后续所有引用项目完成升级后再淘汰 .NET Framework 版本的分支。该方案需要同时维护两份代码，仅适合作为临时过渡方案。

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