JObject枚举采用KeyValuePair<string, JToken?>的原因：JToken何时为null？

你观察到的常规JSON解析后遍历JObject时JToken始终非null是对的，但这个可空类型的设计是为了覆盖以下几个场景：

• 手动构造JObject的合法场景
  当你不是通过JSON反序列化，而是直接用代码手动构建JObject时，可以直接添加值为null的项。比如：

  var jObj = new JObject();
  jObj.Add("manualNull", null);
  foreach (var kvp in jObj)
  {
      // 这里kvp.Value就是null
  }
  

  这种操作是API允许的，所以枚举器的类型必须支持JToken?来容纳这种情况。

• API兼容性与历史设计
  Newtonsoft.Json诞生于C#可空引用类型（Nullable Reference Types）出现之前，早期版本的API可能允许JToken为null的情况。后来为了适配C#的nullable上下文，同时保持对旧代码的兼容，接口签名保留了JToken?的声明，避免强制升级的用户出现编译警告或错误。

• 与其他API的一致性
  JObject的其他方法比如TryGetValue(string key, out JToken? value)，当指定的键不存在时，out参数会返回null。为了让枚举器的键值对类型和这类方法的返回值保持一致，统一使用JToken?，避免类型不一致带来的认知混乱。

需要注意的是：通过标准JSON解析得到的JObject，其中的null值会被解析为JValue.Null（一个非null的JToken实例），而不是null，这也是你测试常规场景时看不到null的原因。

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