Go SJSON Set 与 SetRaw 为什么生成不同类型的值

Go 里用 SJSON 修改 JSON 时，Set 和 SetRaw 的关键区别不是路径，而是“值要不要再次按 JSON 编码”。Set(json, "count", "42") 会得到字符串 "42"；SetRaw(json, "count", "42") 才会得到数字 42。前者适合普通 Go 值，后者适合已经准备好的 JSON 片段。

官方地址：https://github.com/tidwall/sjson

Set 与 SetRaw 的类型边界在哪里

SJSON 官方文档把 Set 描述为设置指定路径的 JSON 值，把 SetRaw 描述为设置一段 raw JSON。可以用同一份文档观察差异：

package main

import (
    "fmt"

    "github.com/tidwall/sjson"
)

func main() {
    doc := `{"count":0,"enabled":false}`

    // Set 会把 Go 字符串编码成 JSON 字符串，所以结果带双引号。
    bySet, err := sjson.Set(doc, "count", "42")
    if err != nil {
        panic(err) // 路径不合法时停止，避免继续使用不完整结果。
    }

    // SetRaw 接收已经写好的 JSON 片段，因此 42 保持 number 类型。
    byRaw, err := sjson.SetRaw(doc, "count", "42")
    if err != nil {
        panic(err) // raw 写入失败时不要把旧文档当成新结果。
    }

    fmt.Println(bySet) // {"count":"42","enabled":false}
    fmt.Println(byRaw) // {"count":42,"enabled":false}
}

因此，问题不在 SJSON 把数字“识别错了”，而在调用者传入的 Go 值和 raw JSON 片段处于不同层次：Set 先做序列化，SetRaw 直接采用序列化后的文本。

不同输入类型应该怎样选择

可以先看目标字段的 JSON 类型，再决定 API。把一个已经带引号的 JSON 片段传给 SetRaw，它仍然会是字符串；把普通 Go 字符串传给 Set，它也不会自动变成数字。

如果数据原本就在 Go 变量中，优先用 Set，例如 int、bool、[]string 或结构体。只有当上游已经生成了完整 JSON，或者需要保留对象、数组的结构时，才使用 SetRaw。

动态 raw 值先检查再写入

SetRaw 的便利也带来责任：raw 参数不是普通字符串，而是一个 JSON 值。动态配置、HTTP 请求或数据库字段送入前，至少确认它能被 JSON 解析；否则错误可能在更晚的读取阶段才暴露。

package main

import (
    "encoding/json"
    "fmt"

    "github.com/tidwall/sjson"
)

func setRawChecked(doc, path, raw string) (string, error) {
    // 先验证 raw 是否是完整 JSON 值，拦截缺引号或括号的输入。
    if !json.Valid([]byte(raw)) {
        return "", fmt.Errorf("invalid raw JSON for %s", path)
    }

    // SetRaw 只负责把合法片段放到目标路径，不替调用者决定业务类型。
    updated, err := sjson.SetRaw(doc, path, raw)
    if err != nil {
        return "", fmt.Errorf("set %s: %w", path, err) // 保留路径上下文便于排查。
    }
    return updated, nil
}

这里的校验只能说明 raw 是合法 JSON，不能说明它符合业务 schema。例如 42 合法，但未必符合某个字段必须是对象的约束；这一步还应由业务层检查字段类型。

排查类型异常时的检查清单

1. 先打印调用参数的 Go 类型：传入的是 string、int 还是已经编码的 JSON 文本。
2. 确认调用的是 Set 还是 SetRaw，不要只看最终字段名。
3. 检查 raw 片段是否带了预期的引号、方括号或花括号。
4. 检查路径中的点号和数组下标；SJSON 使用点号路径，路径错误会返回 error。
5. 在测试中用 json.Unmarshal 断言目标字段的类型，而不是只比较整段字符串。

还要注意，SJSON 文档要求输入 JSON 保持良好格式，并不替调用者全面校验原文。类型修正后，如果仍然出现字段为空或层级不对，应继续看原文合法性和路径语法。

相关问题

SetRaw 能不能直接传 Go map

不能。SetRaw 的参数是 JSON 文本；Go map 应交给 Set，或者先用 json.Marshal 后再经过合法性检查。

Set 写数字字符串为什么总有双引号

因为 Go 中的 "42" 是字符串，Set 会按 JSON 规则把它编码为 "42"。要写数字，应传整数类型或使用合法的 raw JSON。

SetRaw 是否会替业务代码校验类型

不会。它只表达“这是一段原始 JSON”，字段必须是数字、对象还是数组，仍需由调用方的 schema 或业务检查决定。