Conversor CSV ⇄ JSON online
Converta dados nos dois sentidos: transforme um CSV em um array de objetos JSON, ou um array JSON em CSV. A ferramenta lida com campos entre aspas, vírgulas internas e aspas escapadas, e permite escolher o delimitador.
O que é CSV?
CSV (Comma-Separated Values) é um formato de texto simples para representar dados tabulares. Cada linha é um registro e os campos são separados por um delimitador — normalmente a vírgula, mas no Brasil o ponto e vírgula é comum (já que a vírgula é usada como separador decimal).
nome,idade,cidade
Ana,30,São Paulo
Bia,25,Rio de JaneiroO que é JSON?
JSON (JavaScript Object Notation) é o formato dominante para APIs e configurações. Os mesmos dados acima, como array de objetos:
[
{ "nome": "Ana", "idade": "30", "cidade": "São Paulo" },
{ "nome": "Bia", "idade": "25", "cidade": "Rio de Janeiro" }
]Como a conversão funciona
CSV → JSON: a primeira linha é tratada como cabeçalho (nomes das colunas). Cada linha seguinte vira um objeto, associando cada valor ao seu cabeçalho.
JSON → CSV: o JSON deve ser um array de objetos. A ferramenta calcula a união de todas as chaves de todos os objetos para gerar os cabeçalhos, garantindo que nenhuma coluna seja perdida mesmo que alguns objetos tenham campos ausentes.
Tratamento de campos especiais
CSV exige cuidado quando os valores contêm caracteres especiais. Esta ferramenta segue a convenção da RFC 4180:
- Campos que contêm o delimitador, aspas ou quebra de linha são envolvidos em aspas duplas
- Aspas dentro de um campo são escapadas duplicando-as (
"vira"")
Exemplo: o valor Empresa "Acme", Ltda é exportado como "Empresa ""Acme"", Ltda".
Escolhendo o delimitador
| Delimitador | Quando usar |
|---|---|
Vírgula ( , ) | Padrão internacional, APIs |
Ponto e vírgula ( ; ) | Excel em português/Brasil (vírgula é decimal) |
| Tabulação ( Tab ) | TSV, colar de planilhas |
Perguntas frequentes
Por que os números viram strings no JSON?
O CSV é um formato puramente textual — não há como saber se 30 deveria ser número, string ou código. Para evitar conversões incorretas (como perder zeros à esquerda em CEPs ou CPFs), a ferramenta mantém todos os valores como strings. Você pode converter os tipos no seu código depois.
O Excel gera CSV com ponto e vírgula. Funciona?
Sim. Basta selecionar o delimitador ponto e vírgula no conversor. No Brasil, o Excel usa ; por padrão porque a vírgula é o separador decimal.
Posso converter JSON com objetos aninhados para CSV?
Objetos e arrays aninhados são convertidos para uma string JSON dentro da célula CSV. O CSV é um formato plano (tabular), então estruturas profundas não têm representação direta em colunas.
Meus dados são enviados a algum servidor?
Não. Toda a conversão acontece localmente no seu navegador via JavaScript. Nenhum dado é transmitido.