Uma nova API Go para JSON

A nova API `encoding/json/v2` do Go provoca debate sobre como a serialização JSON deve equilibrar segurança de tipos, desempenho e ergonomia em uma linguagem relativamente simples. Os comentaristas contrastam a serialização baseada em reflexão em tempo de execução com garantias de tempo de compilação vistas em linguagens como Rust e Haskell, discutem padrões como a codificação de slices e maps nil, e observam os trade-offs de oferecer schemas ou tipagem mais forte em um formato projetado para flexibilidade. A mudança também é vista no contexto mais amplo da evolução deliberadamente lenta da biblioteca padrão do Go, de seu papel emergente como uma boa opção para código gerado por LLM e da nova prática de pacotes versionados da stdlib como `json/v2` e `math/rand/v2` para lançar melhorias incompatíveis sem interromper o código existente.

API Marshal, Erros e Segurança de Tipos

  • Debate sobre por que json.Marshal retorna um erro:
    • Um lado: erros de serialização geralmente são bugs do programador (tipos não serializáveis) e deveriam ser detectados em tempo de compilação ou até provocar panic.
    • Outros: a entrada pode incluir tipos cuja capacidade de serialização só é conhecida em tempo de execução (any, floats não finitos, erros personalizados de MarshalJSON, falhas de lazy loading), então retornar error é justificável.
  • Alguns argumentam que o JSON baseado em reflexão do Go é “implícito” e que outras linguagens oferecem serialização/deserialização com segurança de tipos em tempo de compilação.
  • Contra-argumento: a API geral do Go baseada em any/interfaces é intencionalmente reutilizável; se você quer garantias mais fortes, use structs tipados ou APIs diferentes.

Nova API JSON v2 e Usabilidade

  • Muitos veem o encoding/json/v2 de forma positiva, especialmente pela API mais limpa e pelas opções.
  • Alguns sentem falta de MarshalIndent; outros apontam funcionalidade equivalente via jsontext.Value.Indent ou opções WithIndent, embora isso seja visto como menos óbvio.
  • O v2 adiciona recursos como melhor configuração de opções, mas não muda radicalmente as abstrações.

Coleções nil vs vazias em JSON

  • Novo padrão: slices/maps nil são serializados como arrays/objetos vazios.
  • Defensores: isso combina com a forma como a maior parte do código Go trata conceitualmente nil vs vazio; o comportamento do v1 causava bugs.
  • Críticos: igualar nil e vazio quebra o round-tripping exato e complica a semântica de PATCH/atualização parcial, onde null vs “ausente” importa.
  • Reclamação mais ampla: a semântica de “zero value” do Go e o comportamento de nil tornam a (de)serialização precisa difícil.

Desempenho, Schemas e Parsing Avançado

  • Discussão sobre parsing em estágios / SIMD / parsing ciente de schema (referenciando trabalho acadêmico).
  • Alguns afirmam que “a maioria dos usuários de JSON não quer schemas/forte tipagem”; outros discordam fortemente, citando uso intenso de JSON Schema, OpenAPI e bibliotecas tipadas (por exemplo, designs no estilo serde).
  • Consenso: JSON é simples como formato, mas implementações robustas, rápidas e totalmente corretas, cobrindo todos os casos-limite (números, chaves duplicadas, limites), são complexas.

Ecossistema do Go, Ritmo e Era de LLM

  • Sentimentos mistos sobre a evolução lenta do Go (generics, módulos, JSON v2 levando anos).
  • Alguns apreciam a estabilidade e o design deliberado; outros veem o Go como “incompleto” ou lento demais para adotar ideias já conhecidas.
  • Vários comentários enquadram o Go como bem adequado para código gerado por LLM: tempos de compilação rápidos, sintaxe simples, revisão fácil.
  • Contra-argumentos: outras linguagens (Rust, Kotlin, C#, OCaml, etc.) podem ser preferíveis dependendo do equilíbrio desejado entre simplicidade e desempenho.