.NET/C#：如何忽略源生成.g.cs文件的GenerateDocumentationFile分析

以下几种配置方式可以直接添加到你的.csproj文件中解决问题：

方法一：彻底禁用源生成文件的分析与文档生成 #

如果不需要对这些自动生成的代码做任何分析和文档生成，用这段配置：

<ItemGroup>
  <Compile Include="**/*.g.cs">
    <IsAnalyzable>false</IsAnalyzable>
    <GenerateDocumentationFile>false</GenerateDocumentationFile>
  </Compile>
</ItemGroup>

• <IsAnalyzable>false</IsAnalyzable>：关闭对这些文件的所有代码分析规则检查
• <GenerateDocumentationFile>false</GenerateDocumentationFile>：让这些文件不参与最终文档文件的生成

方法二：仅抑制文档缺失警告（精准控制） #

如果只想消除文档相关的警告（比如常见的CS1591：缺少XML注释），保留其他代码分析规则，用这段配置：

<ItemGroup>
  <Compile Include="**/*.g.cs">
    <NoWarn>$(NoWarn);CS1591</NoWarn>
  </Compile>
</ItemGroup>

这里的CS1591是文档缺失警告的代码，把它追加到文件的NoWarn列表里，就能跳过该类警告的检查。

方法三：精准定位obj目录下的源生成文件 #

如果源生成的文件都在项目的obj目录下，可以更精准地过滤，避免影响你自己编写的同名文件：

<ItemGroup>
  <Compile Include="obj/**/*.g.cs">
    <GenerateDocumentationFile>false</GenerateDocumentationFile>
    <IsAnalyzable>false</IsAnalyzable>
  </Compile>
</ItemGroup>

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