如何在构建输出中屏蔽XML注释警告且保留IDE内警告？

可以通过以下几种实用方式实现需求：

方法一：项目文件条件配置 #

编辑项目的.csproj文件，添加以下配置，仅在非IDE构建场景下屏蔽CS1591警告：

<PropertyGroup>
  <!-- 启用XML文档生成，让IDE识别需要注释的项 -->
  <GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>

<!-- 仅当不在IDE内构建时，屏蔽CS1591警告 -->
<PropertyGroup Condition="'$(BuildingInsideIDE)' != 'true'">
  <NoWarn>$(NoWarn);CS1591</NoWarn>
</PropertyGroup>

BuildingInsideIDE是IDE构建时自动设置的属性，命令行构建（如dotnet build）不会触发该条件，既能隐藏构建输出中的警告，又不影响Rider的注释提示。

方法二：编译Target临时屏蔽 #

通过添加编译前的Target，仅在构建编译阶段临时屏蔽CS1591警告：

<PropertyGroup>
  <GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>

<Target Name="SuppressBuildWarnings" BeforeTargets="CoreCompile">
  <!-- 编译前将CS1591追加到忽略警告列表 -->
  <PropertyGroup>
    <NoWarn>$(NoWarn);CS1591</NoWarn>
  </PropertyGroup>
</Target>

这种方式下，Rider的代码分析不受任何影响，仍会正常提示注释缺失，但实际构建编译时会跳过该警告的输出。

方法三：分离IDE检查与编译器警告 #

利用Rider独立的代码检查规则替代编译器警告：

1. 打开Rider设置：File | Settings | Editor | Inspections | C# | Code style issues
2. 找到Missing XML comment for publicly visible type or member，将其严重级别设为「警告」并启用
3. 编辑.csproj文件，全局屏蔽编译器的CS1591警告：

<PropertyGroup>
  <NoWarn>$(NoWarn);CS1591</NoWarn>
</PropertyGroup>

配置完成后，Rider会通过自身检查规则提示注释缺失，而编译器构建时不再输出该警告。

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