如何提前识别.NET Framework库中未在.NET Standard 2.0/2.1完整实现的调用方法

1. 启用.NET官方兼容性分析器 #

这是最高效的筛查方案，该分析器内置在.NET SDK中，可直接识别签名存在但实际无有效实现、会抛出PlatformNotSupportedException的API调用：

• 在项目文件中添加以下配置即可启用：

<PropertyGroup>
  <EnablePlatformCompatibilityAnalyzer>true</EnablePlatformCompatibilityAnalyzer>
  <AnalysisLevel>latest-all</AnalysisLevel>
  <WarningsAsErrors>$(WarningsAsErrors);CA1416;CA2252</WarningsAsErrors>
</PropertyGroup>

• 配置后编译阶段就会直接标记出类似Thread.Abort这类不兼容API的调用位置，无需等待运行时触发错误。

2. 使用ApiCompat工具做深度API兼容性校验 #

ApiCompat是微软官方提供的API一致性校验工具，可以将你的程序集调用的API和.NET Standard 2.0/2.1的实际有效实现清单做对比：

• 可识别出所有签名符合.NET Standard规范，但实际功能被裁剪、仅保留空实现或固定抛异常的API
• 支持批量扫描整个项目的所有依赖调用，覆盖范围比编译器内置规则更广

3. 匹配官方不支持API清单 #

微软官方维护了完整的.NET跨版本不支持API列表，其中包含所有在.NET Standard中存在签名、但在.NET Core/.NET 5+运行时中无有效实现的API：

• 你可以将项目的API调用清单导出后和该列表做批量匹配，一次性筛查所有潜在风险点
• 列表中会明确标注每个API的不支持原因、替代方案，方便后续修复

4. 多目标框架编译验证 #

如果你需要同时兼容.NET Framework和.NET Standard/.NET 5+，可以给项目配置多目标框架：

• 同时针对.NET Framework和你要兼容的.NET版本编译
• 不同目标框架下的API兼容性问题会在编译阶段直接暴露，可结合条件编译代码针对性处理兼容逻辑

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