如何通过程序集级SuppressMessage抑制xsd.exe生成代码的CS1591警告？

方案1：精准配置程序集级SuppressMessage #

如果之前的GlobalSuppressions.cs未生效，大概率是目标匹配格式错误。xsd.exe生成的构造函数属于类的成员，需要用正确的通配符和Target格式来匹配所有自动生成的构造函数：

在GlobalSuppressions.cs中添加以下代码：

[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage(
    "Style", 
    "CS1591:Missing XML comment for publicly visible type or member",
    Justification = "代码由xsd.exe自动生成，无需手动添加注释",
    Scope = "member",
    Target = "M:*.#ctor"
)]

• Scope="member"指定抑制的是成员（构造函数属于成员）；
• Target="M:*.#ctor"用通配符*匹配所有命名空间下的所有类的构造函数（#ctor是构造函数的元数据标识）；
• 若需要同时抑制生成类本身的警告，可再添加一条Scope为type的规则：

[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage(
    "Style", 
    "CS1591:Missing XML comment for publicly visible type or member",
    Justification = "代码由xsd.exe自动生成，无需手动添加注释",
    Scope = "type",
    Target = "T:*"
)]

注意：确保项目能识别System.Diagnostics.CodeAnalysis命名空间，或直接使用完整类名。

方案2：针对生成文件单独禁用警告（推荐） #

相比全局抑制，更精准的方式是在csproj中仅对xsd.exe生成的代码文件禁用CS1591，避免影响手动编写的代码：

假设生成的代码文件都放在GeneratedXsdClasses目录下，修改csproj文件：

<ItemGroup>
  <Compile Include="GeneratedXsdClasses\*.cs">
    <NoWarn>CS1591</NoWarn>
  </Compile>
</ItemGroup>

如果是通过构建目标动态生成的文件，可在生成目标中直接设置该属性：

<Target Name="GenerateXsdClasses" BeforeTargets="Compile">
  <Exec Command="xsd.exe your-schema.xsd /c /out:GeneratedXsdClasses" />
  <ItemGroup>
    <Compile Include="GeneratedXsdClasses\*.cs">
      <NoWarn>CS1591</NoWarn>
    </Compile>
  </ItemGroup>
</Target>

方案3：结合partial类补充注释（辅助方案） #

xsd.exe支持/enableDataBinding参数生成partial类，你可以手动创建对应的partial类文件添加类型注释（但构造函数仍在自动生成的文件中，需搭配前两种方案解决构造函数的警告）：

// 手动创建的partial类文件，不会被xsd.exe覆盖
/// <summary>
/// 自动生成的用户数据模型
/// </summary>
public partial class UserDataModel { }

为什么之前的GlobalSuppressions未生效？ #

常见原因包括：

• Target格式错误：构造函数的元数据标识是#ctor，而非类名；
• Scope设置错误：构造函数属于member，而非type；
• 规则类别错误：CS1591属于Style类别，部分旧版本可能用Microsoft.StyleCop或其他类别，需匹配正确的类别名称；
• 项目未启用代码分析：确保csproj中<EnableCodeAnalysis>true</EnableCodeAnalysis>（.NET 5+默认启用）。

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