Conversor JSON e CSV
- Cole um JSON que seja uma lista — a conversão exige um array no nível mais externo.
- Ajuste o delimitador. Vírgula é o padrão internacional; ponto e vírgula costuma ser necessário para abrir no Excel em português.
- Deixe "cabeçalho" ligado para que a primeira linha traga os nomes das colunas.
- Copie o CSV pronto ou salve em arquivo.
CSV é uma tabela: linhas e colunas, sem hierarquia. Por isso a entrada precisa ser um array. Um objeto solto no nível externo é recusado com aviso explícito, em vez de gerar um CSV torto.
O caso ideal é uma lista de objetos com as mesmas chaves — cada objeto vira uma linha e cada chave vira uma coluna.
Se os objetos tiverem chaves diferentes, as colunas são a união de todas, e cada linha preenche apenas as que possui.
Valores aninhados, como um objeto ou array dentro de um campo, não têm representação natural em CSV. Achate a estrutura antes de converter se esses dados importam.
A vírgula é o separador padrão do formato — o C de CSV vem dela.
Em configurações regionais que usam vírgula como separador decimal, incluindo a brasileira, o Excel espera ponto e vírgula. Um CSV com vírgula abre com tudo em uma coluna só.
Tabulação é uma terceira opção útil quando os dados contêm vírgula e ponto e vírgula com frequência.
Campos que contêm o delimitador, aspas ou quebra de linha são automaticamente envolvidos em aspas, como manda o formato.
A conversão acontece inteiramente no seu navegador. Nada do JSON colado é enviado para servidores ou registrado.
- Cole o conteúdo do CSV.
- Ajuste o delimitador se o arquivo não usar vírgula — no Brasil, ponto e vírgula é comum, porque a vírgula já é separador decimal.
- Mantenha "cabeçalho" ligado se a primeira linha traz os nomes das colunas: o JSON sai como lista de objetos. Desligado, sai como lista de listas.
- Escolha se quer o JSON formatado ou compacto.
Linhas vazias são ignoradas, o que evita um objeto nulo no fim do arquivo — problema frequente em CSV exportado de planilha.
Valores são convertidos por tipo quando possível: 42 vira número, true vira booleano, e o resto permanece texto. Isso poupa uma etapa de tratamento, mas é bom conhecer o efeito colateral descrito abaixo.
Campos entre aspas com vírgula, quebra de linha ou aspas escapadas dentro são tratados conforme a especificação do formato.
A conversão de tipos é conveniente até encontrar dados que só parecem números. Um CEP como 01310 vira 1310, perdendo o zero à esquerda. Um CPF sem pontuação vira número e perde precisão por exceder o limite de inteiro seguro do JavaScript.
A regra prática: se a coluna é identificador — documento, código de produto, telefone, CEP — o valor deveria permanecer texto.
Quando o dado importa, confira o JSON gerado antes de usar. Notação científica no resultado é sinal claro de que um identificador longo foi tratado como número.
A conversão acontece inteiramente no seu navegador. Nenhuma linha do CSV é enviada para servidores nem registrada.
É o que torna seguro converter export de base de clientes, relatório financeiro ou qualquer planilha com dado pessoal.
Perguntas frequentes
Envolva em colchetes para virar uma lista de um item, ou extraia o array de dentro dele. CSV representa tabela, e tabela precisa de linhas.
O Excel em português espera ponto e vírgula como separador. Gere novamente com esse delimitador, ou use a importação de dados do Excel escolhendo a vírgula manualmente.
Não há representação natural em CSV. Achate a estrutura antes — transformando cliente.nome em uma coluna própria, por exemplo.
O campo é automaticamente envolvido em aspas, conforme o formato. Aspas dentro do valor são duplicadas.
Não. Tudo é convertido no seu navegador.
Sim, basta ajustar o delimitador. Planilhas em português costumam exportar com ponto e vírgula porque a vírgula já serve de separador decimal.
Porque a conversão automática de tipos entendeu a coluna como número. Identificadores deveriam permanecer texto — se possível, exporte a coluna já entre aspas na origem.
Com cabeçalho, cada linha vira um objeto com as chaves tiradas da primeira linha. Sem cabeçalho, cada linha vira uma lista de valores, na ordem original.
Funciona, desde que o campo esteja entre aspas, como manda o formato. Aspas dentro do campo devem estar duplicadas.
Não. Tudo é processado no navegador e nada fica armazenado.