jsonnode是.net 6+推荐的轻量级可变json树模型,创建空对象用jsonobject.create()或jsonnode.parse("{}"),嵌套构建需确保父节点存在,动态操作需判空并正确转型,序列化用tojsonstring()且清空字段应调remove()而非赋null。

用 JsonNode 创建空对象和嵌套结构
从 .NET 6 开始,JsonNode 是官方推荐的轻量级、可变 JSON 树模型,比 JObject 更现代、无需引用 Newtonsoft。创建空对象直接调用静态方法:JsonNode.Parse("{}") 或更简洁地用 JsonObject.Create()。
嵌套时别直接 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></string> 构建也同理,但要注意 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() 会栈溢出 —— 动态构造时得自己避免。










