如何将基于Roslyn的分析器打包为NuGet包并在.NET Framework 4.5项目中使用？

咱们先拆解下问题根源：
当你直接用<Analyzer>引用dll时，MSBuild是直接把这个dll当成编译器工具加载的，完全跳过了NuGet的运行时兼容性检查——毕竟Roslyn分析器是跑在编译器进程（比如Visual Studio里的MSBuild）里的，不是跑在你的.NET Framework 4.5项目运行时里。而编译器进程通常是.NET Framework 4.7.2及以上版本，完全能加载netstandard2.0的dll。

但换成NuGet引用就不一样了：NuGet默认会把包当成运行时依赖来检查兼容性，而netstandard2.0的官方兼容矩阵里，最低支持的.NET Framework版本是4.6.1，并不包含4.5，所以就抛出了NU1202这个兼容性错误。

下面给你几个可行的解决办法，选哪个看你的需求：

办法一：修改分析器包的兼容性声明 #

直接在你的分析器项目的.csproj里加配置，明确告诉NuGet这个包虽然目标是netstandard2.0，但也兼容.NET Framework 4.5：

<PropertyGroup>
  <CompatibleFrameworks>
    <CompatibleFramework TargetFramework="netstandard2.0" />
    <CompatibleFramework TargetFramework="net45" />
  </CompatibleFrameworks>
</PropertyGroup>

如果愿意的话，也可以把分析器改成多目标编译，同时生成netstandard2.0和net45两个版本的dll：

<PropertyGroup>
  <TargetFrameworks>netstandard2.0;net45</TargetFrameworks>
</PropertyGroup>

这样打包出来的NuGet包会包含两个框架版本，NuGet会自动给你的net45项目匹配对应的版本，从根源上避免兼容性报错。

办法二：在.NET Framework 4.5项目里加回退设置 #

要是不想改分析器的包，也可以在你的net45项目的.csproj里添加PackageTargetFallback配置，让NuGet放宽兼容性检查：

<PropertyGroup>
  <PackageTargetFallback>$(PackageTargetFallback);netstandard2.0</PackageTargetFallback>
</PropertyGroup>

这会让NuGet允许你引用支持netstandard2.0的包到net45项目里，毕竟咱们的分析器不是运行时依赖嘛。

办法三：确保分析器在NuGet包里的位置正确 #

还有个容易忽略的点：分析器dll必须放在NuGet包的指定目录里，NuGet才会把它识别为Roslyn分析器（而不是普通的运行时库）。你可以在分析器项目的.csproj里加这段配置来保证打包路径正确：

<ItemGroup>
  <!-- 打包C#分析器到指定目录 -->
  <None Include="bin\$(Configuration)\$(TargetFramework)\MyAnalyzers.dll" 
        Pack="true" 
        PackagePath="analyzers/dotnet/cs" />
  <!-- 如果有代码修复模块，也一起打包 -->
  <None Include="bin\$(Configuration)\$(TargetFramework)\MyAnalyzers.CodeFixes.dll" 
        Pack="true" 
        PackagePath="analyzers/dotnet/cs" />
</ItemGroup>

要是路径不对，NuGet还是会把它当成普通库来检查兼容性，自然会报错。

备注：内容来源于stack exchange，提问作者Przemaas