在Go语言 json 处理领域，在 json 数据处理中，读取与修改是两个核心需求。前文介绍的 GJSON 解决了灵活读取问题，而 SJSON 作为其姊妹库，则专注于实现无需结构体定义的 json 动态修改。

本文将延续对比分析风格，解析 SJSON 的核心价值。

Go 原生 json 修改方式

Go 原生修改 json 数据，同样需先定义结构体，然后再将 json 数据解析到结构体实例，如：

package main

import (
	"encoding/json"
	"fmt"
)

type Person struct {
	Name string `json:"name"`
	Age  int    `json:"age"`
}

func main() {
	jsonStr := `{"name":"张三","age":25}`

	var person Person
	err := json.Unmarshal([]byte(jsonStr), &person)
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}

	person.Age = 35
	newJson, _ := json.Marshal(person)

	fmt.Println(string(newJson))
}

SJSON 组件

概述

SJSON 提供通过路径表达式直接修改 json 字符串的能力，与 GJSON 采用相同路径语法，形成读写闭环。

官网地址：GitHub - tidwall/sjson

安装

使用 Go 的包管理工具 go get 安装 SJSON：

go get -u github.com/tidwall/sjson

SJSON 核心用法

基础值修改

package main

import (
	"fmt"
	"github.com/tidwall/sjson"
)

func main() {
	jsonStr := `{"name":"张三","age":25}`

	// 修改 age 值为 35
	newJson, _ := sjson.Set(jsonStr, "age", 35)

	fmt.Println(string(newJson))
}

嵌套结构修改

package main

import (
	"fmt"
	"github.com/tidwall/sjson"
)

func main() {
	jsonStr := `{
		"name": "张三",
		"age": 25,
		"hobby": {
			"h1": "sing",
            "h2": "dance",
            "h3": "rap",
            "h4": "basketball"
		}`

	// 修改 hobby.h4 的值: basketball => football
	newJson, _ := sjson.Set(jsonStr, "hobby.h4", "football")

	fmt.Println(string(newJson))
}

数组操作

package main

import (
	"fmt"
	"github.com/tidwall/sjson"
)

func main() {
	jsonStr := `{"hobby": ["sing","dance","rap","basketball"]}`

	// 修改 hobby 数组第4个元素为 football
	newJson, _ := sjson.Set(jsonStr, "hobby.3", "football")

	fmt.Println(string(newJson))

	// 追加 hobby 数组第5个元素为 game
	newJson, _ = sjson.Set(jsonStr, "tags.-1", "game")
	fmt.Println(string(newJson))
}

字段删除

package main

import (
	"fmt"
	"github.com/tidwall/sjson"
)

func main() {
	jsonStr := `{"name":"张三","age":25}`

	// 删除age字段
	newJson, _ := sjson.Delete(jsonStr, "age")

	fmt.Println(string(newJson))
}

SJSON 与原生方案对比

  • SJSON 摆脱结构体定义束缚，保持原始 json 结构完整性，避免修改后丢失未定义字段的问题。

  • SJSON 路径直达修改位置，规避嵌套结构嵌套带来的问题，与 GJSON 组成完整处理链路。

  • SJSON 支持运行时动态路径构建，避免硬编码路径带来的问题。