Go 1.27 traz encoding/json/v2 e encoding/json/jsontext como APIs generalmente disponíveis

Segundo o go.dev, o encoding/json/v2 e o encoding/json/jsontext saem do status experimental e ficam estáveis no Go 1.27. A motivação é que vários problemas do encoding/json (v1) são consequência da própria API e não dá para corrigi-los sem quebrar a promessa de compatibilidade do Go 1. Criar nomes como MarshalV2 seria, nas palavras do texto, um namespace paralelo dentro do mesmo pacote. Daí o caminho do v2.

O jsontext cuida só da sintaxe (Encoder, Decoder, Value e Token, sem reflection e com streaming de verdade). O json/v2 cuida da semântica, a relação entre valores JSON e valores Go. As interfaces novas MarshalerTo e UnmarshalerFrom operam direto sobre Encoder e Decoder, o que permite repassar opções pela pilha de chamadas e evita o parse duplo que o UnmarshalJSON exige. Os padrões mudam: UTF-8 inválido e nomes duplicados viram erro, slices e maps nil saem como array e objeto vazios, o casamento de campos passa a diferenciar maiúsculas de minúsculas, e omitempty é redefinido. Serializar time.Duration também gera erro, com opções para o chamador decidir. Sobre desempenho, o Marshal fica em paridade com o v1 e o Unmarshal chega a ser até 10x mais rápido em benchmarks. O texto cita ganhos de ordens de grandeza no kube-openapi do Kubernetes ao trocar para UnmarshalJSONFrom, e promete mais melhorias no Go 1.28.

Para quem mantém APIs em Go, a migração tende a ser mais de revisar comportamentos padrão do que de reescrever código, já que a fonte diz que usos do v1 devem funcionar quase igual no v2. O ponto de atenção é o contrato com clientes: nil virando [] e campos case-sensitive podem alterar respostas e entradas aceitas. Quem tem tipos com MarshalJSON e UnmarshalJSON próprios ganha mais ao implementar as variantes To e From.