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
nulle 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
[{"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.