为何将Enum转换为String时触发Possible Null Reference警告？

以下是几种可能导致该警告的情况，并非Visual Studio误判，大多和C#的可空引用类型特性及框架版本有关：

• 未覆盖所有枚举成员的分支判断
  如果你的属性getter中使用switch或if-else处理枚举值，却没有覆盖所有枚举成员，也未添加default分支，编译器会认为存在未处理的路径，可能返回null（即使你实际不会让代码走到这些路径）。比如：

  public string ArmorTypeStr
  {
      get
      {
          return _armorType switch
          {
              ArmorType.Helmet => "头盔",
              ArmorType.Chest => "胸甲"
              // 未处理ArmorType.Legs等其他成员，也无default分支
          };
      }
  }
  

  这种情况下编译器会触发警告，因为它无法确认未处理的分支会返回有效值。

• 目标框架缺少可空注解
  如果项目目标是.NET Framework（如4.x版本），该版本的基础类库方法没有添加可空性注解。编译器无法确定Enum.ToString()的返回值一定非空，因此会发出警告。而在.NET 5及以上版本中，Enum.ToString()被标注了[return: NotNull]，编译器会明确知道它不会返回null，不会触发警告。

• 可空引用类型特性的严格检查
  当项目开启了可空引用类型（在项目文件中设置<Nullable>enable</Nullable>），编译器会对所有引用类型的返回值进行严格的可空性分析。如果编译器无法通过静态分析确认返回值一定非空，就会触发警告——哪怕实际运行时不会返回null。

补充说明：枚举作为值类型，确实不会为null，且Enum.ToString()对任何枚举值（包括未定义的枚举数值）都会返回非空字符串（要么是枚举成员名称，要么是对应的数字字符串），运行时不会出现null。警告只是编译器静态分析的结果，而非运行时的实际风险。

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