Lobsters | 📄 原文链接 | 2026-11-06 收录

Go 1.27 的编码库 v2：把十五年的旧账一次还清

来源：go.dev — 2026-11

📋 概述

encoding/json 的问题不在于功能少，而在于语义已经焊进公开 API，受 Go 1 兼容承诺保护无法修改。Go 团队于是另开 encoding/json/v2 与底层的 encoding/json/jsontext：前者管语义，后者只管语法且完全不依赖反射。v2 把选项变成一等参数，提供真正流式的 MarshalWrite、UnmarshalRead 与 MarshalJSONTo、UnmarshalJSONFrom，并改掉大小写不敏感匹配、非法 UTF-8 静默通过、重复键、omitempty 等一堆坑。反序列化基准最高快 10 倍；v1 在底层就是用 v2 加一整套兼容选项实现的，所以两边能互操作、可以渐进迁移。

🔑 核心要点

三类根因：行为缺陷（大小写不敏感匹配、指针接收者方法调用不一致）、API 缺陷（Reader 难用、选项无法穿透）、性能限制（MarshalJSON 强制分配、UnmarshalJSON 必须整段解析两次、无流式）。
jsontext 只处理语法，不碰反射，名字取自 RFC 8259 里对 JSON 文法的称呼。
v2 的选项是一等参数，Marshal、Unmarshal、Write、Read、Encode、Decode 六个入口共享同一套配置。
MarshalJSONTo 与 UnmarshalJSONFrom 让自定义类型真正流式处理，Kubernetes 的 OpenAPI 解析因此快了几个数量级。
行为差异包括：非法 UTF-8 报错、重复键报错、nil slice 编成空数组、字段匹配改大小写敏感、omitempty 重定义、time.Duration 默认报错。
v1 由 v2 加兼容选项实现，因此 v1 用户自动获得新方法与新标签，生态可以平滑迁移。

💡 金句

我们想要的不只是让 v1 继续可用，而是保证 v1 与 v2 彼此兼容。

← 返回 Lobsters 首页