YAML vs JSON: Principais Diferenças e Quando Usar Cada Um
YAML e JSON são ambos formatos de dados, mas foram criados para humores diferentes: JSON para máquinas conversando com máquinas, YAML para humanos escrevendo configuração. Este artigo contrasta suas estruturas, tipos e peculiaridades para você escolher o certo e migrar entre eles com limpeza.
O que o JSON faz de melhor?
JSON é um formato rígido e explícito com apenas quatro tipos de valor: strings, números, booleanos e null, além de arrays e objetos. Essa rigidez o torna fácil de analisar, validar e passar em APIs, por isso ele domina payloads web e bancos de dados.
O que o YAML acrescenta para humanos?
YAML lê como prosa levemente formatada: indentação substitui chaves, aspas muitas vezes são opcionais e ele suporta comentários, âncoras e strings de várias linhas. Para arquivos de configuração que pessoas abrem e editam todos os dias, essa legibilidade é uma vantagem real.
Quais peculiaridades podem te morder em cada formato?
A indentação importa no YAML, e um único espaço fora do lugar muda o significado. O YAML também tem "tipos pegadinha": um valor sem aspas pode virar número ou booleano silenciosamente. O JSON evita essas surpresas porque cada tipo é explícito, mas as regras de vírgula são implacáveis.
Quando escolher cada formato?
Use YAML para configuração local, pipelines de CI, manifests do Kubernetes e qualquer coisa que um humano edite com frequência. Use JSON para APIs, troca de dados entre serviços, documentos de banco e qualquer coisa que máquinas consumam em alto volume.
Como migrar entre os dois formatos?
Os dois compartilham quase todos os tipos de dados, então a conversão costuma ser sem perdas. Converta YAML para JSON ou de volta com o conversor YAML JSON, que detecta a origem, valida a sintaxe e controla a indentação da saída.