JSON Pretty Print vs JSON Format: qual a diferença?

Resposta curta: para JSON, „pretty print“ e „format“ são a mesma coisa —— e „beautify“ também. Os três significam adicionar indentação consistente e quebras de linha para deixar a estrutura legível, sem mudar os dados. A confusão é real porque algumas operações de fato diferentes (minify, validar, visão em árvore) estão por perto. Este guia esclarece a terminologia e mostra o que realmente difere.

Pretty Print, Format, Beautify —— A mesma operação

„Pretty print JSON“, „format JSON“ e „beautify JSON“ descrevem a mesma operação: pegar um valor JSON (muitas vezes uma string compacta de uma linha) e re-serializar com indentação e quebras de linha. A saída é semanticamente idêntica à entrada —— qualquer parser produz os mesmos dados a partir de qualquer das duas formas, porque o whitespace entre tokens é insignificante em JSON.

// Compacto (o que uma API devolve)
{"user":{"name":"Ada","roles":["admin","editor"]}}

// Pretty-printed / formatted / beautified —— dados idênticos
{
  "user": {
    "name": "Ada",
    "roles": [
      "admin",
      "editor"
    ]
  }
}

Então, se uma ferramenta oferece „Format“, „Beautify“ e „Pretty Print“ como botões separados, eles fazem o mesmo trabalho. Não há distinção técnica útil para aprender.

Então o que realmente é diferente?

As distinções úteis não estão entre pretty-print e format —— estão entre formatar e estas operações vizinhas:

Minify é o oposto exato de pretty print —— veja Como minificar JSON. Validação é uma checagem separada (Como validar JSON), e explorar payloads grandes como árvore é outra coisa (Visualizador em árvore de JSON). Se a sua entrada nem parseia, antes de formatar você precisa reparar.

Como pretty print JSON

A mecânica é a mesma, qualquer que seja a palavra usada pela ferramenta:

// JavaScript —— o terceiro argumento é a indentação
JSON.stringify(value, null, 2);                 // de um valor
JSON.stringify(JSON.parse(raw), null, 2);       // de uma string JSON

# Python
import json
json.dumps(data, indent=2)

# Linha de comando
jq . data.json                                  # jq faz pretty-print por padrão
python3 -m json.tool data.json

Para o passo a passo completo —— ordenar chaves, opções de CLI, converter outros formatos —— veja Como formatar JSON.

Pretty print de JSON online

Para pretty-print sem escrever código, cole o seu JSON em JSON Fix: ele formata com indentação consistente de 2 espaços (e repara os erros comuns antes, então funciona mesmo se o JSON não estiver totalmente válido), tudo no seu navegador e sem upload. Prefere uma visão interativa de um documento grande? Use o JSON Viewer.

Perguntas frequentes

„pretty print JSON“ é o mesmo que „format JSON“?

Sim. Em JSON, pretty print, format e beautify significam a mesma coisa: adicionar indentação e quebras de linha para a leitura sem mudar os dados.

O pretty print muda meus dados JSON?

Não. O whitespace entre tokens é insignificante em JSON, então as formas pretty-printed e compacta fazem parse para a mesma estrutura de dados.

Como faço pretty print de JSON em JavaScript?

Use JSON.stringify(value, null, 2) —— o terceiro argumento define a indentação (2 espaços, 4 espaços ou '\t' para tabs). Faça parse antes se começar de uma string.

Qual é o oposto de pretty print em JSON?

Minificar —— remover todo o whitespace insignificante para produzir JSON compacto em uma linha. Veja Como minificar JSON.

Ferramentas e guias relacionados

• JSON Fix —— pretty-print (e repare) JSON no seu navegador
• Como formatar JSON —— o how-to completo com código e CLI
• Como minificar JSON —— a operação oposta
• JSON Viewer vs JSON Formatter —— visualizar vs formatar
• O que é JSON? —— por que o whitespace é insignificante