CSV ⇄ JSON

Conversor bidirecional gratuito · Sem login · Roda no seu navegador
Entrada — CSV
Saída — JSON

    

Como Funciona a Conversão de CSV para JSON

CSV (Valores Separados por Vírgula) e JSON (JavaScript Object Notation) são dois dos formatos de intercâmbio de dados mais comuns. O CSV é compacto e compatível com planilhas; o JSON é hierárquico e nativo para APIs web. Esta ferramenta permite que você transite entre eles na hora, inteiramente no seu navegador.

O Formato CSV (RFC 4180)

A especificação oficial do CSV (RFC 4180) define as regras que este conversor segue exatamente:

  • Os campos são separados por um delimitador (padrão: vírgula). A opção de detecção automática analisa seus dados e escolhe o mais adequado.
  • Campos que contêm o delimitador, aspas duplas ou quebras de linha devem ser delimitados por aspas duplas.
  • Uma aspa dupla dentro de um campo entre aspas é representada por duas aspas duplas consecutivas ("").
  • A primeira linha costuma ser a linha de cabeçalho, com os nomes das colunas.
  • As linhas são separadas por CRLF ou LF — ambos funcionam.

Inferência de Tipos

Quando a inferência de tipos está ativada (padrão), os valores em formato de texto são convertidos automaticamente para tipos nativos do JSON:

  • "42"42 (número)
  • "3.14"3.14 (número)
  • "true" / "false"true / false (booleano)
  • "" ou "null"null
  • Todo o resto permanece como texto.

Desative a inferência de tipos quando precisar de saída estritamente textual — por exemplo, quando uma coluna de CEPs como 01234 deve permanecer "01234" e não virar 1234.

Chaves com Ponto → Objetos Aninhados

Ative Expandir chaves com ponto para transformar um cabeçalho como endereco.cidade em uma estrutura JSON aninhada: {"endereco": {"cidade": "..."}}. Útil ao preparar dados para uma API hierárquica que espera objetos aninhados.

JSON → CSV: Achatar Objetos Aninhados

Ao converter JSON de volta para CSV, objetos aninhados são automaticamente achatados usando chaves com ponto. Um objeto {"usuario": {"nome": "Alice", "idade": 30}} vira duas colunas: usuario.nome e usuario.idade.

Atalhos de Teclado

  • Ctrl/Cmd+Enter — Converter agora
  • Ctrl/Cmd+D — Baixar saída
  • Ctrl/Cmd+Shift+C — Copiar saída

Armadilhas Comuns do CSV

  • Vírgulas dentro dos valores: Se seus dados contêm vírgulas (ex.: "Silva, João"), o campo deve ser delimitado por aspas. Este conversor trata isso corretamente conforme o RFC 4180.
  • Contagens de colunas inconsistentes: Alguns exportadores produzem linhas com campos finais ausentes. Este conversor preenche os valores ausentes com null e avisa quais linhas foram afetadas.
  • Caracteres BOM: Arquivos exportados do Excel às vezes começam com um BOM UTF-8 (). Este conversor o remove automaticamente.
  • Codificação: Arquivos enviados são lidos como UTF-8. Se o seu CSV usa outra codificação (ex.: Latin-1), converta-o para UTF-8 antes.
  • Arquivos grandes: Arquivos acima de 5 MB podem tornar a pré-visualização mais lenta. O conversor os processará, mas limitará a pré-visualização às primeiras 50 linhas.

CSV vs JSON: Quando Usar Cada Um

Use CSV quando: compartilhar dados tabulares com usuários não técnicos, importar para planilhas, trabalhar com grandes conjuntos de dados planos onde os nomes das colunas são estáveis.

Use JSON quando: trabalhar com APIs web, armazenar dados hierárquicos ou aninhados, usar scripts JavaScript/Node.js/Python, ou quando os valores podem conter vírgulas ou caracteres especiais.

Perguntas Frequentes

Não. Toda a conversão acontece inteiramente no seu navegador com JavaScript. Seus dados CSV ou JSON nunca saem do seu dispositivo. Verifique a aba Rede do navegador — você verá zero requisições de saída durante a conversão.
O conversor amostra as primeiras 5 linhas e conta as ocorrências de vírgula, ponto e vírgula, tabulação e barra vertical. O caractere que aparece mais consistentemente entre as linhas (especialmente no cabeçalho) é selecionado como delimitador. Você sempre pode substituí-lo manualmente.
Sim. O parser é totalmente compatível com RFC 4180. Campos delimitados por aspas duplas podem conter vírgulas, quebras de linha embutidas e aspas duplas escapadas (duas aspas duplas consecutivas representam uma aspa literal). Isso trata corretamente exportações do Excel e campos de endereço com múltiplas linhas.
Array de objetos (padrão) usa a linha de cabeçalho como chaves: [{"nome":"Alice","idade":30}]. É o que a maioria das APIs e bibliotecas espera. Array de arrays preserva as linhas brutas: [["nome","idade"],["Alice","30"]], útil para grades de dados e operações matriciais.
Selecione as células do Excel e pressione Ctrl+C (elas são copiadas como valores separados por tabulação). Cole na caixa de entrada — a detecção automática reconhece o delimitador de tabulação automaticamente. Você também pode salvar o arquivo do Excel como CSV (Arquivo → Salvar Como → CSV) e enviá-lo usando o botão Enviar Arquivo.
Não há limite imposto, mas o navegador pode ficar lento acima de 5 MB. Um aviso é exibido acima desse limite. A pré-visualização ao vivo é sempre limitada às primeiras 50 linhas para melhor desempenho. A saída completa da conversão é sempre integral.