JSON vs CSV

Forma: uma tabela versus uma árvore

Um arquivo CSV é uma sequência de registros, cada um da mesma largura: nome, e-mail, valor, repetidos a cada linha. Uma linha de cabeçalho — convenção, não garantia — dá nome às colunas uma vez para o arquivo inteiro. Registros JSON, em vez disso, carregam suas chaves consigo, então todo objeto é autodescritivo, e um objeto pode conter um array de objetos que contêm arrays. Essa assimetria decide a escolha de formato mais do que qualquer lista de recursos.

Tipos e aspas: declarados versus inferidos

No JSON, o tipo de um valor é visível: aspas significam string, dígitos soltos significam número, e true, false e null são tokens exatos. No CSV, o arquivo não afirma nada — 007 e 7 são ambos texto de célula simples, e cada consumidor reinfere os tipos sob suas próprias regras. A RFC 4180 especifica as aspas com precisão: campos contendo vírgulas, aspas duplas ou quebras de linha são envolvidos em aspas duplas, e aspas internas são dobradas. Arquivos que ignoram isso produzem os clássicos bugs de linha quebrada que todo engenheiro de dados já depurou.

A etapa de reinferência é onde os dados corrompem em silêncio. Um código postal 02134 vira o número 2134; 1.20 vira 1.2; um número de conta longo vira 4.2E+12. JSON tem a regra espelhada — números não podem ter zeros à esquerda de forma alguma, então um código postal também precisa ser string lá — mas ao menos a declaração é explícita, em vez de um chute feito pela planilha de outra pessoa.

Excel, dados em volume e onde cada formato vence

O comportamento do Excel merece parágrafo próprio porque queima tantos pipelines. O Excel abre CSV nativamente, mas redefine o tipo de cada célula usando o locale da máquina: zeros à esquerda somem, marcações ISO de data e hora viram datas no formato local, e em boa parte da Europa vale o dialeto do ponto e vírgula, porque a vírgula é separador decimal. Ao salvar, o arquivo é reescrito com essas inferências gravadas para sempre. JSON nunca passa pelo Excel, o que por si só já é uma razão para integrações preferi-lo.

Em escala, a natureza plana do CSV é uma vantagem: linhas são processadas uma a uma com memória constante, e é por isso que exportações de vários gigabytes e ferramentas orientadas a colunas ainda falam CSV primeiro. JSON vence onde o consumidor é um programa e a estrutura é real: payloads de API, configuração, documentos aninhados. Escolher pelo consumidor, e não pela moda, resolve a maioria das discussões em uma frase.

Quando escolher cada um — e como a conversão se comporta

Escolha CSV quando o destino é tabular: planilhas, cargas em massa em banco de dados, ferramentas de BI e de ciência de dados. Escolha JSON quando a estrutura se aninha ou o consumidor é código. A orientação se inverte o tempo todo em pipelines reais: uma API devolve JSON, um analista quer CSV, um fornecedor manda CSV que um serviço precisa ingerir — conversão é manutenção de rotina, não um projeto de migração.

A conversão tem limites honestos. JSON para CSV precisa achatar: um array de objetos vira linhas, a união das chaves deles vira colunas, e qualquer array ou objeto aninhado precisa ser transformado em string, unido ou descartado. CSV para JSON precisa inferir: células vazias viram null ou strings vazias, e células com cara de número viram números. Os conversores deste site documentam exatamente essas regras em vez de adivinhar em silêncio.