Formatacao e indentacao JSON: boas praticas de tabs vs espacos

2024-06-14

Formatar nao e so estetica: uma indentacao consistente melhora revisao e reduz ruido de merge. Veja como escolher e quando comprimir.

Espacos na especificacao JSON

Espacos e quebras de linha nao afetam o parser; estilo e uma decisao humana e de equipe.

Tabs vs espacos

Prefira espacos para consistencia entre editores e diffs mais limpos. Tabs sao validos, mas raros em exemplos JSON publicos.

2 vs 4 espacos

Dois espacos dominam nos ecossistemas front-end e Node; quatro aparecem em algumas configs Java/Python. Escolha um padrao por repositorio.

{
  "user": {
    "name": "Alice",
    "roles": ["admin", "editor"]
  }
}

Quando usar pretty-print

Debug, documentacao e edicao manual: formate antes da revisao para que o diff mostre mudancas reais.

Quando minificar

Transporte em producao e economia de armazenamento. Mantenha uma versao legivel separada; nao edite JSON minificado manualmente.

Dicas para equipes

Use .editorconfig para arquivos json. Parse check opcional no CI. Exemplos em docs com 2 espacos; logs podem ficar minificados.