<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

encoding/json/v2 no Go 1.27: por que seus Marshal e Unmarshal nunca mais serão iguais

DA

4 min

Entusiasta das Tecnologias

encoding/json/v2 no Go 1.27: por que seus Marshal e Unmarshal nunca mais serão iguais

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.

Neste artigo

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.

Produtos relacionados

Este conteúdo tem links de afiliado: se você comprar por eles, podemos receber uma comissão sem custo extra para você. A escolha dos produtos segue critérios próprios e não é influenciada por comissão.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar Cirino

Entusiasta das Tecnologias

Atualizado em 09/11/2026 •

Sou o Cirino, e desenvolvo soluções e produtos utilizando linguagens de programação e ferramentas de analytics e monitoração baseadas em Cloud. Trabalho com tecnologia desde 2010,...

Ver perfil do autor

COMPARTILHAR