如何在保留警告转错误设置下处理.NET 8新BCL弃用警告？

我们的C#项目一直使用以下配置：

<TreatWarningsAsErrors>true</TreatWarningsAsErrors>
<WarningsNotAsErrors>612,618</WarningsNotAsErrors>

该配置实现了两个核心效果：

• 全局将警告视为错误，强制开发者及时修复代码问题；
• 将“已过时/已弃用”类的CS0612、CS0618警告设为特例，仅保留为警告状态，方便在不中断构建的前提下提前知晓代码中的弃用风险，后续逐步迭代修复。

但在.NET 8中，BCL新增了一系列以SYSLIB为前缀的弃用警告，例如：

• SYSLIB0051：旧版序列化支持API弃用提示
• SYSLIB0050：基于格式化程序的序列化弃用提示
• SYSLIB0040：特定加密策略弃用提示
• SYSLIB0011：二进制格式化程序序列化弃用提示
• 其他同类型SYSLIB前缀警告

我们的代码库包含数百个项目，这类警告数量庞大，无法一次性全部修复，但又不想取消全局警告转错误的设置。请问如何高效地将这些新的弃用警告仍视为警告而非错误？

另外，我们也想了解：为什么.NET 8的框架弃用要新增这些SYSLIB前缀的警告，而不是沿用现有的CS0612和CS0618？

1. 扩展WarningsNotAsErrors配置 #

直接在现有项目配置中追加需要忽略的SYSLIB警告编号即可，注意SYSLIB警告可以省略前缀，仅写数字部分：

<TreatWarningsAsErrors>true</TreatWarningsAsErrors>
<WarningsNotAsErrors>612,618,0011,0040,0050,0051</WarningsNotAsErrors>

后续有新增的同类型警告，继续以逗号分隔追加编号即可。

2. 用Directory.Build.props统一配置（推荐） #

针对数百个项目的场景，逐个修改项目配置效率极低，推荐在代码库根目录创建Directory.Build.props文件，将配置统一放在此处，所有子项目会自动继承该配置：

<Project>
  <PropertyGroup>
    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
    <WarningsNotAsErrors>612,618,0011,0040,0050,0051</WarningsNotAsErrors>
  </PropertyGroup>
</Project>

后续需要新增或调整忽略的警告时，仅修改这一个文件即可，无需逐个项目操作。

3. 局部范围抑制警告（可选） #

如果仅需针对特定项目或代码块处理警告，可以使用以下方式：

• 项目级抑制：在目标项目文件中添加NoWarn配置

<PropertyGroup>
  <NoWarn>$(NoWarn);SYSLIB0051;SYSLIB0050</NoWarn>
</PropertyGroup>

• 代码级抑制：在触发警告的代码段前后添加预处理指令

#pragma warning disable SYSLIB0051
// 触发SYSLIB0051警告的代码逻辑
#pragma warning restore SYSLIB0051

这种方式适合局部少量警告的处理，不建议大规模使用。

.NET团队新增SYSLIB前缀的弃用警告而非沿用CS0612/CS0618，主要有以下原因：

1. 区分警告来源：CS前缀警告由C#编译器发出，属于语言层面的提示；SYSLIB前缀警告由.NET类库（BCL）自身发出，属于框架API层面的提示，两者分属不同体系，便于开发者快速定位问题类型。
2. 实现精细控制：新的SYSLIB警告针对不同的API场景做了细分，比如不同序列化方式、加密策略对应不同的警告编号，开发者可以更精准地选择需要忽略或优先修复的警告类型。
3. 适配版本化弃用策略：SYSLIB警告可以和.NET版本绑定，针对不同版本的框架弃用规则发出对应提示；而CS0612/CS0618是通用的语言级弃用提示，无法做到版本和场景的精准匹配。
4. 提供更明确的迁移引导：这类新警告通常附带更详细的迁移建议，比如替代API的说明，帮助开发者更高效地完成代码升级，而传统CS0612/CS0618的提示信息相对简洁。

内容的提问来源于stack exchange，提问作者F-H