如何在.NET Standard项目中强制非兼容程序集触发编译时错误？

一、针对项目引用：将NU1702警告升级为错误 #

项目引用非兼容.NET Framework项目时会触发NU1702警告，只需将该警告强制设为错误，就能在编译阶段直接拦截：

在.NET Standard项目的.csproj文件中添加如下配置：

<PropertyGroup>
  <!-- 仅将NU1702设为错误，不影响其他警告 -->
  <WarningsAsErrors>NU1702</WarningsAsErrors>
  <!-- 若需要将所有警告都转为错误，可启用下面一行 -->
  <!-- <TreatWarningsAsErrors>true</TreatWarningsAsErrors> -->
</PropertyGroup>

二、针对直接程序集引用：自定义MSBuild目标做兼容性检查 #

直接引用.dll文件时不会触发NU1702，需要通过自定义MSBuild任务主动验证每个引用程序集与.NET Standard 2.0的兼容性，在编译阶段报错：

在项目的.csproj文件中添加以下自定义Target：

<Target Name="CheckAssemblyCompatibilityWithNetStandard" BeforeTargets="ResolveReferences">
  <ItemGroup>
    <!-- 收集所有带HintPath的引用程序集路径 -->
    <ReferencePaths Include="@(Reference->'%(HintPath)')" Condition="'%(HintPath)' != ''" />
    <!-- 处理未指定HintPath的引用，从输出目录查找 -->
    <ReferencePaths Include="$(OutputPath)%(Reference.Filename).dll" Condition="'%(HintPath)' == ''" />
  </ItemGroup>

  <!-- 使用.NET CLI命令检查程序集兼容性，不兼容则终止编译 -->
  <Exec Command="dotnet verify compatibility --target-framework netstandard2.0 &quot;%(ReferencePaths.FullPath)&quot;" 
        ContinueOnError="false"
        IgnoreExitCode="false" />
</Target>

说明： #

• 需要确保安装了.NET SDK 6.0及以上版本（dotnet verify compatibility命令需较新SDK支持）
• 若有个别确认兼容的程序集被误判，可在<ReferencePaths>的Condition中添加排除规则，例如：Condition="'%(HintPath)' != '' and %(Reference.Filename) != 'TrustedNonCompatibleDll'"

三、全局强制执行检查（覆盖所有项目） #

要让解决方案内所有.NET Standard 2.0项目自动启用上述检查，可在解决方案根目录创建Directory.Build.props文件，内容如下：

<Project>
  <PropertyGroup>
    <!-- 全局将NU1702设为错误 -->
    <WarningsAsErrors>$(WarningsAsErrors);NU1702</WarningsAsErrors>
  </PropertyGroup>

  <!-- 仅对.NET Standard 2.0项目启用程序集兼容性检查 -->
  <Target Name="CheckAssemblyCompatibilityWithNetStandard" BeforeTargets="ResolveReferences" Condition="'$(TargetFramework)' == 'netstandard2.0'">
    <ItemGroup>
      <ReferencePaths Include="@(Reference->'%(HintPath)')" Condition="'%(HintPath)' != ''" />
      <ReferencePaths Include="$(OutputPath)%(Reference.Filename).dll" Condition="'%(HintPath)' == ''" />
    </ItemGroup>

    <Exec Command="dotnet verify compatibility --target-framework netstandard2.0 &quot;%(ReferencePaths.FullPath)&quot;" 
          ContinueOnError="false"
          IgnoreExitCode="false" />
  </Target>
</Project>

所有.NET Standard 2.0项目会自动继承该配置，无需逐个修改.csproj。

四、替代方案：用PackageReference替代直接程序集引用 #

如果条件允许，将依赖的程序集打包为NuGet包，改用<PackageReference>引用：

<PackageReference Include="Lib1" Version="1.0.0" />

NuGet会自动检查包的目标框架兼容性，触发NU1702警告（或错误），配合之前的WarningsAsErrors配置即可在编译阶段拦截问题。

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