C产品如何满足特定用户需求？

本文共计791个文字，预计阅读时间需要4分钟。

从.NET 6开始，`JsonNode`是官方推荐的使用轻量级、可变的JSON树模型的类，相较于`JObject`更现代化且无需依赖Newtonsoft库。创建空对象并直接调用静态方法：

嵌套时别直接 new JsonObject 再手动 Add —— 容易漏掉类型检查。推荐链式构建：

var root = JsonObject.Create(); root["user"] = JsonObject.Create(); root["user"]["name"] = "Alice"; root["user"]["roles"] = JsonArray.Create("admin", "editor");

注意：JsonObject.Create() 返回的是 JsonObject（继承自 JsonNode），而 JsonNode.Parse("{...}") 返回的也是 JsonObject（只要内容是对象）。但 JsonNode.Parse("[...]") 会返回 JsonArray，类型不一致会导致后续赋值失败。

动态增删改字段：用索引器 + null 检查

JsonNode 支持类似字典的索引访问，但对不存在的 key 返回 null，不是抛异常。所以修改前务必判空，否则 node["missing"]?.GetValueKind() 会 NRE。

• 添加或覆盖字段：node["id"] = JsonValue.Create(123)（JsonValue.Create 可转基本类型）
• 删除字段：node.AsObject().Remove("temp") —— 必须先 AsObject() 转型，否则编译不过
• 安全更新嵌套值：if (node["config"] is JsonObject config) { config["timeout"] = 5000; }

常见错误：写 node["data"]["items"] = ... 时，如果 "data" 还没存在，第二层索引会触发 NullReferenceException。必须分步确保父节点存在。

从匿名对象或字典初始化 JsonNode

不能直接把 C# 匿名对象传给 JsonNode.Parse —— 它只接受字符串。想从运行时数据生成 JSON，优先用 JsonSerializer.SerializeToNode()：

var data = new { name = "Bob", active = true, tags = new[] { "dev", "csharp" } }; JsonNode node = JsonSerializer.SerializeToNode(data); // .NET 7+ 才有；.NET 6 需用 JsonSerializer.Deserialize<JsonNode>(JsonSerializer.Serialize(data))

从 Dictionary<string, object> 构建也同理，但要注意 object 值里不能含 DateTime、Stream 等无法序列化的类型，否则 SerializeToNode 抛 NotSupportedException。建议先用 JsonSerializerOptions.Converters.Add(...) 注册自定义转换器处理特殊类型。

序列化输出与 null 值控制

JsonNode.ToJsonString() 默认不忽略 null 值，也不会格式化。要压缩输出加参数：node.ToJsonString(new JsonSerializerOptions { WriteIndented = false })。

关键细节：如果某个字段被设为 JsonValue.Create(null)，它在序列化时仍会输出 "field": null；但若字段根本不存在（即没调过 node["field"] = ...），就不会出现在结果中。所以“清空字段”应使用 Remove()，而不是赋 null。

另外，JsonNode 不支持循环引用检测，如果对象图里有 self-reference，ToJsonString() 会栈溢出 —— 动态构造时得自己避免。