当前位置：首页 > 文章列表 > Golang > Go教程 > Go JSON v2 实战：别急着替换 encoding/json，先搞懂这些变化

Go JSON v2 实战：别急着替换 encoding/json，先搞懂这些变化

来源：Go JSON v2 实验仓库与近期资料参考，17golang 原创解读 2026-06-01 20:04:21 0浏览收藏

Go 项目里 JSON 太常见了：HTTP API、配置、消息队列、日志、第三方回调，哪儿都有它。也正因为太常见，encoding/json 的历史包袱、性能、字段匹配、重复 key、流式处理这些问题，很多团队都踩过。Go 1.25 引入实验性的 JSON v2 和 jsontext，不是让你今天就全量替换，而是给我们一个重新审视 JSON 边界的机会。

这篇我会按生产迁移视角讲：JSON v2 想解决什么问题，哪些行为变化会影响老代码，性能优化该怎么验证，以及什么时候该继续留在 v1。

Go JSON v2 迁移思维导图 — 思维导图：JSON v2 的重点不是单纯更快，而是把语义、安全性、流式能力和迁移边界重新整理清楚。

先别急着换库，先问是不是 JSON 真的慢

我见过不少团队一听到 JSON 性能问题，就准备上第三方库或者代码生成。结果压测一看，真正慢的是数据库、下游 HTTP、锁等待，JSON 只占 3%。这种情况下换 JSON 库，收益不大，风险倒是不小。

正确姿势还是老三样：profile 看 CPU 和分配，benchmark 看热点路径，线上指标看 P95/P99。只有当 JSON 编解码确实在热点路径上，才值得认真评估 v2 或其他方案。

JSON v2 和 jsontext 分工不一样

简单理解，encoding/json/v2 仍然偏向 Go struct 和 JSON 对象之间的映射；encoding/json/jsontext 更接近底层 token 读写，适合你想自己控制流式解析、校验、转换的场景。

如果你的业务只是普通 API DTO，优先看 v2 的行为和选项。如果你在做网关、数据清洗、日志管道、大 JSON 流处理，jsontext 才更值得认真研究。

Go JSON v2 评估落地流程图 — 流程图：先定位热点，再小范围启用实验能力，对比行为差异、性能和兼容性，最后决定是否保留。

几个行为变化要特别小心

JSON v2 更强调数据正确性。比如 UTF-8、重复对象成员名、字段匹配规则这些地方，和老的 encoding/json 可能不完全一样。对新项目这是好事，对老项目就是迁移风险。

最典型的是第三方回调。你以为对方发来的是标准 JSON，实际上可能有重复 key、奇怪编码、大小写混乱字段。v1 也许默默接受了，v2 可能更早暴露问题。这个变化本身不坏，但上线前必须知道哪些输入会被拒绝。

// 迁移前先做影子对比，不要直接替换生产路径
func decodeWithShadow(raw []byte, dst any) error {
    err1 := json.Unmarshal(raw, dst)

    var shadow any
    err2 := jsonv2.Unmarshal(raw, &shadow)
    if (err1 == nil) != (err2 == nil) {
        slog.Warn("json behavior differs",
            "v1_err", err1,
            "v2_err", err2,
        )
    }
    return err1
}