tidwallsjson：Go 里改 JSON，点号路径就够了

tidwall/sjson：Go 里改 JSON，点号路径就够了

tidwall/sjson 在 GitHub 上拿到了 2,709 Star。

Go 里处理 JSON 改值，标准库的路径是：定义 struct、json.Unmarshal、修改字段、json.Marshal 回去。就想把name.last从 “Prichard” 改成 “Anderson”，四步起跳。改一次可以忍，但日志管道、API 网关这种每秒改几百次的场景，序列化和反序列化的开销堆起来之后就是另一回事了。

SJSON 做一件事：用一段点号路径定位到想改的位置，只动那一段字节，其余内容原样保留。

1、一行改一个值

使用方式没有多余的步骤：

value,_:=sjson.Set(json,"name.last","Anderson")

输入{"name":{"first":"Janet","last":"Prichard"},"age":47}，输出{"name":{"first":"Janet","last":"Anderson"},"age":47}。不需要定义 struct，不需要 Unmarshal，不需要 Marshal。路径指向哪里就改哪里。

路径语法是点号分隔的 key：

• "name.last"进入嵌套对象的字段
• "children.1"取数组下标 1 的元素
• "friends.1.last"取数组元素下的嵌套字段

key 本身含 “.” 的情况用\转义。如果 JSON 里用数字作为对象 key（比如{"users":{"2313":{"name":"Sara"}}}），路径写成"users.:2313.name"，加冒号区分数组索引和对象 key。

2、改、删、追加，一个库覆盖

Delete 操作同样简洁：

sjson.Delete(json,"name.first")

数组末尾追加用-1作为 key：

sjson.Set(json,"friends.-1","Sara")

即使在数组边界之外指定索引（数组 2 个元素却在friends.4位置设值），SJSON 自动补 null 填满中间位置，不会 panic。

3、性能：不反序列化整棵树

作者给出的 benchmark，同一段 JSON 文档上轮流操作三个不同路径，结果如下：

SJSON 的 Set 比标准库快约 26 倍，ReplaceInPlace 模式零分配，差距拉到 47 倍。

原理直接在字节层面操作：定位目标字段对应的起止字节位置，替换中间内容。没有 reflect，没有中间对象分配。ReplaceInPlace 模式下，如果新旧值字节长度相同，直接原地覆盖，一次分配都没有。

对高并发 API 网关、日志处理管线、配置中心这类场景，省下的不只是响应时间，还有 GC 开销。

4、类型支持和回退机制

原生支持 nil、bool、int、float、string、slice、map。如果传入的类型不在这个范围，SJSON 自动回退到encoding/json的 Marshaller 处理后再拼接。自定义 struct 照常往里塞，不需要额外适配。

5、作者和配套工具

SJSON 的作者是 Josh Baker（tidwall）。他在 Go 社区还有几个关联项目：

• GJSON：做 JSON 快速查询，路径语法和 SJSON 一致，Star 数比 SJSON 更高
• JJ：把 GJSON 加 SJSON 包装成命令行工具，shell 里直接查改 JSON

想从 JSON 里取某个值用 GJSON，想往 JSON 里改某个值用 SJSON，语法一样，配合起来没有学习成本。

6、适合这些场景

• 配置中心或 API 网关，需要高频修改 JSON 响应中的个别字段
• 日志处理管线，在全量解析之外提供增删字段的能力
• JSON 结构不固定，不适合提前定义 struct
• 和 GJSON 搭配，一读一写覆盖多数 JSON 操作

如果每次都要完整理解 JSON 全貌才能决定改什么，SJSON 帮不上忙。但如果修改路径是已知的、只动一个值，它能省下很大的 CPU 和内存开销。

不上忙。但如果修改路径是已知的、只动一个值，它能省下很大的 CPU 和内存开销。

[外链图片转存中…(img-22wNkboi-1780899443454)]