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() 会栈溢出 —— 动态构造时得自己避免。