如何在C#文档注释中允许&符号并避免CS1570分析器警告

问题本质 #

C# 的XML文档注释遵循严格的XML语法规范，&是XML中的特殊字符，作为实体引用的起始标识使用。当解析器遇到&qux这类内容时，会将qux识别为实体名称，但XML没有定义该实体，因此抛出CS1570警告。

能否配置分析器直接允许未转义& #

没有可直接允许注释中使用未转义&的内置分析器配置。因为该校验是XML解析器的底层语法要求，不属于可灵活关闭的静态分析规则，非合法格式的XML内容无法被正常解析。

更高效的替代方案 #

你提到的现有方案中，最高效的是全局项目级禁用警告，一次配置即可全程直接粘贴URL无需额外处理，配置方式如下：
在项目的.csproj文件中添加如下配置节点：

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

如果后续需要使用DocFX、Sandcastle等工具生成API文档，建议使用IDE的一键修复功能，主流C#开发IDE（Visual Studio、Rider）都支持点击CS1570警告的修复按钮，自动将所有注释中的&转义为&，无需手动修改。

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