JSON, YAML, CSV: Quando Usar Cada Um e Como Converter

Você baixa um conjunto de dados e ele está em CSV. Sua API retorna JSON. Seu arquivo de configuração está em YAML. Um colega envia um arquivo JSON e pede como planilha. Outro colega entrega uma configuração YAML e você precisa dela como JSON para uma ferramenta diferente.

A conversão de formatos de dados é uma daquelas tarefas que parecem triviais até você estar realmente fazendo. Entender quando usar qual formato, e como alternar entre eles, economiza tempo de verdade.

Os Três Formatos em Resumo

JSON (JavaScript Object Notation)

{
  "name": "Alice",
  "age": 30,
  "skills": ["Python", "SQL", "Docker"],
  "address": {
    "city": "Berlin",
    "country": "Germany"
  }
}

O que é: Um formato de texto para dados estruturados que suporta objetos (pares chave-valor), arrays (listas ordenadas), strings, números, booleanos e null.

Pontos fortes: Legível por máquinas, amplamente suportado em todas as linguagens de programação, lida com dados aninhados naturalmente, sintaxe rígida evita ambiguidade.

Pontos fracos: Verboso (muitas chaves, colchetes e aspas), não tão legível para humanos quanto YAML, sem suporte para comentários.

YAML (YAML Ain't Markup Language)

name: Alice
age: 30
skills:
  - Python
  - SQL
  - Docker
address:
  city: Berlin
  country: Germany

O que é: Um formato de serialização de dados amigável para humanos que usa indentação em vez de chaves e colchetes. É um superconjunto de JSON, o que significa que JSON válido também é YAML válido.

Pontos fortes: Extremamente legível, suporta comentários, menos poluição visual, ótimo para arquivos de configuração.

Pontos fracos: Sensível à indentação (fácil de quebrar com espaçamento errado), alguns comportamentos de parsing surpreendentes, mais lento para parsear do que JSON.

CSV (Comma-Separated Values)

name,age,city,country
Alice,30,Berlin,Germany
Bob,25,London,UK
Charlie,35,Paris,France

O que é: Um formato de texto plano onde cada linha é uma linha de dados e os valores dentro de uma linha são separados por vírgulas (ou às vezes ponto e vírgula ou tabulações).

Pontos fortes: Universal (toda planilha, banco de dados e ferramenta de dados o suporta), compacto para dados tabulares, fácil de ler e criar.

Pontos fracos: Sem suporte para dados aninhados, sem tipos de dados (tudo é string), sem padrão para caracteres especiais, limitado a tabelas planas.

Quando Usar Cada Um

Convertendo Entre Formatos

JSON para YAML

Esta é a conversão de configuração mais comum. Você tem uma configuração JSON de uma ferramenta e precisa de YAML para outra. A conversão é direta porque YAML suporta tudo que JSON suporta.

{"server": {"host": "0.0.0.0", "port": 8080}}

Se torna:

server:
  host: 0.0.0.0
  port: 8080

YAML para JSON

Ir de YAML para JSON também é simples, mas você perde comentários (JSON não os suporta) e o resultado é mais verboso.

JSON para CSV

Isso funciona bem para arrays JSON planos (arrays de objetos com as mesmas chaves). Cada objeto se torna uma linha, e cada chave se torna um cabeçalho de coluna.

[
  {"name": "Alice", "age": 30},
  {"name": "Bob", "age": 25}
]

Se torna:

name,age
Alice,30
Bob,25

CSV para JSON

Cada linha se torna um objeto, com cabeçalhos de coluna como chaves. Isso é limpo para dados tabulares simples.

CSV para YAML

Menos comum, mas segue a mesma lógica: cada linha se torna um mapeamento YAML, e o arquivo inteiro se torna uma sequência YAML.

Armadilhas Comuns

Problemas de Codificação CSV

Arquivos CSV podem usar diferentes codificações de caracteres (UTF-8, Latin-1, Windows-1252). Se você abrir um CSV e vir caracteres ilegíveis como "München" em vez de "München", é um problema de codificação. Sempre use UTF-8 quando possível.

Confusão de Delimitador CSV

Nem todos os CSVs usam vírgulas. CSVs europeus frequentemente usam ponto e vírgula porque vírgulas são usadas como separadores decimais em muitos formatos numéricos europeus. Valores separados por tabulação (TSV) são outra variante comum.

Erros de Indentação YAML

YAML usa indentação (espaços, nunca tabulações) para definir estrutura. Uma indentação inconsistente, ou misturar tabulações e espaços, produz erros de parsing ou interpretação incorreta silenciosa. Use exatamente 2 espaços por nível de indentação e configure seu editor para inserir espaços em vez de tabulações.

Vírgulas Finais em JSON

JSON não permite vírgulas finais. Isso é válido em JavaScript mas inválido em JSON:

{"name": "Alice", "age": 30,}  // JSON inválido: vírgula final

Performance com Arquivos Grandes

Para conjuntos de dados muito grandes (milhões de linhas), CSV é mais eficiente que JSON ou YAML porque tem overhead mínimo por registro. JSON adiciona chaves e aspas para cada valor, o que aumenta significativamente o tamanho do arquivo para grandes dados tabulares.

Ferramentas Práticas para Conversão

Para conversões rápidas e pontuais, ferramentas baseadas em navegador são a opção mais rápida. Você cola ou envia seus dados, seleciona o formato de destino e obtém o resultado imediatamente.

Para trabalhar especificamente com JSON, um formatador que valida e indenta seu JSON é indispensável:

• Formatador JSON — validar, formatar e minificar JSON
• Conversor JSON para CSV — converter arrays JSON para CSV
• Conversor YAML-JSON — converter entre YAML e JSON
• Visualizador CSV — visualizar e explorar arquivos CSV

Converta seus dados agora:

• Converter Formatos de Dados
• Formatador JSON
• JSON para CSV
• Conversor YAML-JSON

Todas as ferramentas são gratuitas e funcionam diretamente no seu navegador.