Neste artigo
- encoding/json/v2 no Go 1.27: por que seus Marshal e Unmarshal nunca mais serão iguais
- O que o v2 corrige do v1
- Performance real
- Como migrar um codebase grande
- O encoding/json/v2 é estável em 2026?
- Quanto o v2 é mais rápido que o v1?
- O que acontece com nil slice no marshal agora?
- Posso usar os dois pacotes juntos no mesmo projeto?
- O v1 vai ser removido?
- Migre um módulo esta semana
encoding/json/v2 no Go 1.27: por que seus Marshal e Unmarshal nunca mais serão iguais
O Go encoding json v2 tutorial começa pela data: o Go 1.27 saiu em 19 de agosto de 2026 e tornou estáveis os pacotes `encoding/json/v2` e `encoding/json/jsontext`, segundo o post do Go Blog de 4 de novembro de 2026.
A mudança é grande: o `Unmarshal` do v2 chegou a ficar até 10x mais rápido que o v1 em benchmarks oficiais, e o pacote corrige falhas de comportamento que o `encoding/json` carregava desde antes do Go 1.0.
O que o v2 corrige do v1
O post oficial lista as falhas do pacote antigo. O v1 aceitava UTF-8 inválido, descumprindo o RFC 8259, e aceitava nomes de membros duplicados em objetos, caso explorado antes no CVE-2017-12635. No v2, as duas situações viram erro por padrão.
Também muda o marshal de slice e mapa nil: no v1 virava `null`, o que quebrava quem esperava array ou objeto; no v2 vira array ou objeto vazio. A resolução de nomes case-insensitive no unmarshal, um risco de segurança, foi revista, e a chamada inconsistente de métodos `MarshalJSON` em receiver ponteiro foi corrigida.
Performance real
O post de 4 de novembro de 2026 mostra que o `Unmarshal` do v2 é significativamente mais rápido, com ganhos de até 10x nos benchmarks. Para ainda mais velocidade, quem implementa `Marshaler`/`Unmarshaler` deve migrar para `MarshalerTo` e `UnmarshalerFrom`, que processam JSON em modo streaming puro.
A API básica segue parecida: `json.Marshal`, `json.MarshalWrite`, `json.MarshalEncode`, `json.Unmarshal`, `json.UnmarshalRead` e `json.UnmarshalDecode`, agora com opções via `opts ...Options`.
Como migrar um codebase grande
- Troque o import de `encoding/json` para `encoding/json/v2` num branch isolado.
- Rode a suíte de testes: a meta do time do Go é que usos do v1 funcionem quase igual no v2.
- Revise os pontos em que seu código dependia de `null` para nil: agora sai `[]` ou `{}`.
- Ative o modo estrito de UTF-8 e nomes duplicados nos testes para pegar regressões cedo.
- Meça com benchmark antes e depois; em cargas pesadas de leitura JSON, o ganho de até 10x aparece no `Unmarshal`.
Perguntas frequentes
O encoding/json/v2 é estável em 2026?
Sim. Ficou estável e GA no Go 1.27, lançado em 19 de agosto de 2026, junto com o encoding/json/jsontext.
Quanto o v2 é mais rápido que o v1?
O Unmarshal pode ficar até 10x mais rápido segundo os benchmarks do post oficial de 4 de novembro de 2026. O Marshal também muda, mas o ganho maior está na leitura.
O que acontece com nil slice no marshal agora?
No v1, nil virara null. No v2, vira array vazio ou objeto vazio, que é o que a maioria dos usuários prefere segundo a pesquisa citada no post.
Posso usar os dois pacotes juntos no mesmo projeto?
Durante a migração dá, mas o recomendado é ir branch a branch trocando o import para v2 até cobrir tudo.
O v1 vai ser removido?
Não. O v1 segue existindo por compatibilidade, mas novos projetos e migrações devem olhar primeiro para o v2.
Migre um módulo esta semana
Escolha um serviço que faz muito parse de JSON, troque o import para `encoding/json/v2` e rode os testes com o modo estrito ligado. Se passar, rode o benchmark e veja o ganho real no seu caso.
Aproveite para ler mais na editoria de programação, ver vagas de desenvolvimento que pedem Go e seguir as trilhas de estudo. Se for PJ, confira na calculadora CLT vs PJ o valor da sua hora com esse diferencial.
Dados conforme os posts oficiais do Go Blog: Go 1.27 is released (19/08/2026) e A new Go API for JSON (04/11/2026), consultados em 6 de novembro de 2026.