用于 JSON 的新的 Go API

Go 的新 `encoding/json/v2` API 引发了关于 JSON 序列化应如何在类型安全、性能和易用性之间取得平衡的讨论,尤其是在这样一门相对简单的语言里。评论者比较了基于运行时反射的 marshalling 与 Rust、Haskell 等语言中的编译期保证,争论 nil slice 和 map 的默认编码方式,并指出在一个以灵活性为目标的格式上支持 schema 或更强类型时的权衡。此次变化也被放在更大的背景下讨论:Go 标准库刻意缓慢的演进、它作为 LLM 生成代码良好目标语言的潜力,以及像 `json/v2` 和 `math/rand/v2` 这样的版本化 stdlib 包如何在不破坏现有代码的前提下发布破坏性改进。

Marshal API、错误与类型安全

  • 关于为什么 json.Marshal 会返回错误的争论:
    • 一方认为:marshalling 的错误通常是程序员 bug(无法被 marshal 的类型),应该在编译时捕获,甚至直接 panic。
    • 另一方认为:输入可能包含只有在运行时才知道是否可 marshal 的类型(any、非有限浮点数、自定义 MarshalJSON 错误、延迟加载失败),因此返回 error 是合理的。
  • 有些人认为 Go 基于反射的 JSON 是“隐式的”,而其他语言提供编译期类型安全的(反)序列化。
  • 反驳观点:Go 基于 any/interface 的通用 API 是有意为之,便于复用;如果想要更强保证,可以使用强类型 struct 或不同的 API。

新的 JSON v2 API 与可用性

  • 很多人对 encoding/json/v2 持积极态度,尤其喜欢它更清晰的 API 和选项。
  • 有些人怀念 MarshalIndent;也有人指出可以通过 jsontext.Value.Indent 或 WithIndent 选项实现等价功能,只是这不够直观。
  • v2 增加了更好的选项配置等特性,但并没有从根本上改变抽象方式。

JSON 中的 nil 与空集合

  • 新默认行为:nil slice/map 会序列化为空数组/对象。
  • 支持者认为:这更符合大多数 Go 代码对 nil 与空的概念理解;v1 的行为会导致 bug。
  • 批评者认为:把 nil 和空混为一谈会破坏精确的往返序列化,并让 PATCH/部分更新语义更复杂,因为 null 和“缺失”是不同的。
  • 更广泛的抱怨是:Go 的“零值”语义和 nil 行为使精确的(反)序列化变得棘手。

性能、Schema 与高级解析

  • 讨论了分阶段解析 / SIMD / schema 感知解析(引用了学术工作)。
  • 有人声称“多数 JSON 用户不想要 schema/强类型”;也有人强烈反对,指出 JSON Schema、OpenAPI 以及类型化库(例如 serde 风格设计)的广泛使用。
  • 共识是:JSON 作为格式很简单,但要实现健壮、快速、完全正确且覆盖所有边缘情况(数字、重复键、限制等)的实现却很复杂。

Go 的生态、发展速度与 LLM 时代

  • 对 Go 演进缓慢的看法不一(generics、modules、JSON v2 花了很多年)。
  • 有人欣赏这种稳定性和谨慎设计;也有人觉得 Go “不完整”或对已知想法的采纳太慢。
  • 一些评论认为 Go 很适合 LLM 生成的代码:编译快、语法简单、易于审查。
  • 反驳意见:根据对简单性与性能的平衡需求,Rust、Kotlin、C#、OCaml 等其他语言可能更合适。