依据微软文档，.NET Standard 2.0引用.NET 4.6.1程序集为何失败？

嘿，这个问题我之前帮朋友踩过坑，微软文档里的支持确实存在，但有不少容易忽略的前提条件，给你列几个最常见的报错原因：

• 被引用项目类型不对：你要确保FullFramework.csproj是纯类库（Class Library）项目，要是控制台、WinForms或者WPF这类带有特定框架依赖的项目，.NET Standard项目根本没法直接引用——毕竟.NET Standard是一个通用API规范，不包含UI或.NET Framework专属的运行时组件。

• 用到了.NET Standard不兼容的API：虽然文档说支持≤4.6.1的.NET Framework库，但如果你的FullFramework项目里用了仅.NET Framework有的API（比如System.Web下的类、Microsoft.Win32.Registry的某些专属方法，或者过时的Legacy API），编译时就会触发错误。你可以用Visual Studio自带的「分析 -> 可移植性分析器」工具，或者运行dotnet analyze命令来检测项目里的不兼容API。

• 项目配置声明有误：手动检查两个项目的csproj配置：

  • 确认NetStandard项目的目标框架是正确的：

    <TargetFramework>netstandard2.0</TargetFramework>
    

  • 确认FullFramework项目的目标框架≤4.6.1：

    <TargetFramework>net461</TargetFramework>
    

  如果是手动添加项目引用，还可以尝试在NetStandard的csproj里显式添加引用并指定PrivateAssets="all"，避免依赖传递问题：

  <ProjectReference Include="..\FullFramework\FullFramework.csproj">
    <PrivateAssets>all</PrivateAssets>
  </ProjectReference>
  

• NuGet包依赖冲突：如果FullFramework项目引用了仅支持.NET Framework的NuGet包，这些包没有对应的.NET Standard兼容版本，就会导致依赖解析失败。这种情况优先尝试把这些包升级到支持.NET Standard的版本，要是暂时没法升级，可以在PackageReference里添加NoWarn="NU1701"来忽略兼容性警告（但这只是临时 workaround，长期来看还是建议替换兼容包）。

• Visual Studio版本不达标：微软明确是从Visual Studio 15.3（也就是VS 2017 15.3版本）开始支持这个特性，如果你用的是更早的VS版本，肯定会报错。确认下你的VS版本，至少要升级到VS 2017 15.3及以上，VS 2019或2022自然也没问题。

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