EN
PT
ES
Conversor JSON ↔ CSV
Transforme um array JSON em CSV (ou o contrário). Escolha o delimitador, achata objetos aninhados com notação por ponto, controla a linha de cabeçalho.
O que este conversor faz
JSON e CSV são os dois formatos que mais circulam entre APIs, planilhas, jobs de ETL e dashboards. JSON guarda tipos e aninhamento; CSV é plano e funciona muito bem com Excel, Google Sheets, ferramentas de BI e a maioria dos data warehouses. Este conversor vai nos dois sentidos. JSON para CSV pega um array de objetos e gera uma linha por objeto, com cabeçalho formado pela união de todas as chaves vistas. Objetos aninhados são achatados com notação por ponto (user.city), então nada se perde. Arrays viram, por padrão, sua representação JSON em uma célula. CSV para JSON faz o caminho contrário: lê campos com aspas no estilo RFC 4180 (com aspas escapadas e quebras de linha embutidas), converte true, false, null e números puros para os tipos correspondentes em JSON e reconstrói objetos aninhados a partir de chaves com pontos no cabeçalho. Toda a conversão roda localmente no seu dispositivo — seus dados nunca saem do navegador, nunca vão para nossos servidores, e não são armazenados, indexados, registrados ou compartilhados. Essa garantia de privacidade importa para o tipo de dado que costuma passar por um conversor: respostas de API com PII, exportações de clientes, métricas internas, qualquer coisa vinda de um banco de produção.
Como usar
Escolha o sentido, escolha o delimitador, cole os dados — a saída atualiza ao vivo.
- Escolha o sentido — Use JSON → CSV quando tem uma resposta de API ou um export e quer abrir em planilha. Use CSV → JSON quando exportou de Excel, Sheets ou banco e quer dados estruturados.
- Escolha o delimitador — Vírgula é o padrão universal. Use ponto e vírgula para CSVs gerados por Excel europeu, Tab para conteúdo vindo da área de transferência do Excel/Sheets ou pipe para arquivos de log onde a vírgula já aparece nos dados.
- Decida sobre achatamento — Deixe Achatar objetos aninhados ligado se o JSON tem dados aninhados — você terá colunas como
address.cityeaddress.zip. Desligue se preferir embutir o objeto aninhado como string JSON em uma célula. - Copie ou cole de volta — Use o botão de copiar para levar o resultado. CSV cola direto no Excel, Sheets ou no editor; JSON cola no Postman, na sua IDE ou em qualquer lugar que aceite um corpo JSON.
Regras de escape e aspas
CSV não tem uma especificação oficial única, mas a RFC 4180 captura o consenso que todo parser moderno segue. Um campo é envolvido em aspas duplas se contiver o delimitador, aspas duplas, quebra de linha ou retorno de carro. Dentro de um campo com aspas, as aspas duplas são escapadas duplicando-as (diga "oi" vira "diga ""oi"""). Quebras de linha dentro de um campo com aspas são mantidas — o parser conta as aspas não escapadas para saber se ainda está dentro do campo. null e undefined viram células vazias; isto significa que um round-trip JSON → CSV → JSON não consegue distinguir string vazia de null. Números, booleanos e o literal null são reconhecidos no caminho CSV → JSON, então uma célula com true vira um booleano em JSON.
Como os valores são escapados
Alguns exemplos do que o conversor faz em casos delicados. O delimitador nestes exemplos é a vírgula.
| Valor de entrada | Célula CSV |
|---|---|
hello | hello |
a,b | "a,b" |
say "hi" | "say ""hi""" |
line1\nline2 | "line1\nline2" |
null | (vazio) |
{a: 1, b: 2} | 1,2 com achatamento ligado |
Perguntas frequentes
Meus dados vão para algum lugar?
Não. A conversão ocorre integralmente no navegador. A página não carrega bibliotecas de terceiros para CSV — o parser e o serializador estão no próprio código. Confira em DevTools → Network: nenhum request é disparado quando você cola ou converte.
E se meus objetos têm chaves diferentes?
O cabeçalho é a união de todas as chaves vistas, na ordem em que aparecem pela primeira vez. Linhas que não contêm uma chave geram célula vazia naquela coluna. É o mesmo comportamento de Pandas, importações do Excel e da maioria das ferramentas de ETL.
Como são exportados arrays dentro do JSON?
Arrays são serializados em JSON e colocados em uma célula única, então um objeto como {tags: ["a","b"]} vira uma célula com o texto ["a","b"]. Preserva os dados, mas não ajuda em pivôs na planilha — se quiser uma linha por tag, expanda o array antes de converter.
Por que meu Excel europeu abre o CSV em uma coluna só?
O Excel em vários locais europeus usa ponto e vírgula como delimitador de CSV para deixar a vírgula livre para decimais. Selecione o chip ; no conversor e o arquivo vai e volta sem quebra.
CSV → JSON detecta números e booleanos?
Sim. Células que contêm apenas um número, true, false ou null são convertidas para o tipo JSON correspondente. O resto continua como string. Zeros à esquerda ficam como string, para não estragar telefones e CEPs.
Funciona com arquivos muito grandes?
Até alguns megabytes, sim. Acima disso a aba pode travar porque tudo é síncrono na thread principal. Para exports de centenas de megabytes use ferramentas de linha de comando como jq, csvkit ou miller.