Como converter CSV para JSON (chaves, tipos, delimitadores e codificação)
Converta um arquivo CSV em JSON em quatro passos. A primeira linha vira as chaves, os números continuam números e os zeros à esquerda são mantidos.
Atualizado em 7 de novembro de 20268 min de leitura
Para converter um arquivo CSV em JSON, solte-o no conversor de CSV para JSON, deixe ativada a opção "A primeira linha é o cabeçalho" e clique em Converter. A primeira linha vira as chaves e cada uma das outras linhas vira um objeto, de modo que você recebe um array como [{"id": 1, "name": "Ada"}]. Depois é só copiar o texto ou baixar um arquivo .json. O que decide se o resultado serve não é a conversão em si, mas quatro detalhes: como o delimitador é detectado, como a codificação do arquivo é lida, o que acontece com números e células vazias e qual forma de saída você escolhe. Este guia passa por cada um deles.
O que a conversão faz
Um arquivo CSV é texto simples: uma linha por registro, células separadas por um delimitador e, em geral, uma primeira linha com o nome das colunas. JSON é texto estruturado com chaves, valores e tipos. Converter significa ler cada linha, dividi-la em células, associar cada célula ao nome da sua coluna e escrever os pares como JSON. Com as configurações padrão, um arquivo com o cabeçalho id,name,active e a linha 7,Ada,TRUE vira um objeto com as chaves id, name e active, em que 7 é um número e TRUE é um true de verdade.
Se você só quer dar uma olhada no arquivo antes, abra-o no visualizador de CSV. E se não tem certeza de que JSON é o formato certo para os seus dados, JSON, CSV e XML: qual escolher compara os três.
Converter um arquivo CSV para JSON, passo a passo
Adicione o arquivo
Solte um arquivo .csv, .tsv, .txt ou .psv na página, ou clique em Procurar arquivos. O delimitador, o caractere de aspas e a codificação são detectados e mostrados em "Leitura do arquivo", então você vê o que foi escolhido.
Escolha a forma de saída
Deixe "Forma de saída" em Array de objetos se o resultado for para uma API ou um aplicativo web. As outras quatro formas são explicadas mais abaixo.
Confira a pré-visualização
A pré-visualização mostra os primeiros 200 registros e se atualiza sempre que você muda uma configuração. Olhe as chaves, os números e as células vazias. Se as letras aparecerem erradas ou as colunas estiverem juntas, corrija agora a Codificação ou o Delimitador.
Converta e exporte
Clique em Converter para JSON e depois use Copiar JSON ou Baixar JSON. Tudo é executado no seu dispositivo, não nos nossos servidores.
Todas as formas de saída e todas as opções são gratuitas. Grátis: um arquivo por vez, de até 25 MB. Pro: lotes de até 50 arquivos, download em um único ZIP e combinação dos arquivos em um só documento.
Converter CSV para JSONA primeira linha vira as chaves
Com "A primeira linha é o cabeçalho" ativada, a primeira linha fornece os nomes das propriedades. Com a opção desativada, a primeira linha é tratada como dado e as colunas se chamam column_1, column_2 e assim por diante, então nada se perde. Desative-a para arquivos que começam direto com dados, como muitas exportações de leitores e registradores.
Cabeçalhos reais são mais bagunçados que os dos exemplos, e a ferramenta trata os problemas comuns em vez de escondê-los. Duas colunas chamadas id se sobrescreveriam, então a segunda passa a se chamar id_2. Um cabeçalho vazio recebe o nome da sua posição, por exemplo column_4. Se um relatório tem um título e uma linha em branco acima do cabeçalho de verdade, use "Pular linhas iniciais" para que a linha correta seja o cabeçalho. A configuração "Caixa das chaves" pode deixar as chaves como estão escritas ou passá-las para minúsculas, MAIÚSCULAS, camelCase ou snake_case; nada é renomeado se você não pedir.
Muitas exportações gravam dados aninhados como colunas planas chamadas address.city e address.zip. Ative "Aninhar cabeçalhos com ponto" (ponto ou barra) e elas voltam a se agrupar num objeto address. A opção vem desativada, para que uma coluna que realmente se chama Revenue.2024 continue plana.
Array de objetos ou outra forma?
A forma decide o que fica no nível superior do arquivo. São arquivos diferentes, não apresentações diferentes do mesmo arquivo.
| Forma de saída | Aparência | Use para |
|---|---|---|
| Array de objetos | [{"id": 1, "name": "Ada"}] | APIs, aplicativos JavaScript, a maior parte do código |
| Array de arrays | [["id","name"],[1,"Ada"]] | Dados em matriz, ou arquivos com cabeçalhos duplicados ou ausentes |
| JSON Lines | Um registro por linha, sem colchetes | Importações para bancos de dados e logs |
| Mapa indexado | {"SKU-1": {...}} | Buscar registros por uma coluna de identificador |
| Arrays por coluna | {"id": [1,2], "name": [...]} | Gráficos e bibliotecas de tabelas de dados |
Dois detalhes valem a pena. JSON Lines nunca recebe indentação, porque um registro espalhado em várias linhas quebraria o formato. E num mapa indexado, duas linhas com o mesmo valor de chave não sobrevivem juntas: a última vence e a ferramenta informa quantas linhas foram substituídas.
Números, booleanos, células vazias e zeros à esquerda
Um arquivo CSV não tem tipos: toda célula é texto. A configuração "Ler números, booleanos e null" vem ativada e transforma as células no valor JSON que elas parecem ser. O risco da detecção de tipos é estragar dados, então a ferramenta deixa alguns valores como texto de propósito.
| Célula no CSV | No JSON | Por quê |
|---|---|---|
| 42 ou 3,14 | 42 ou 3,14 (números) | Números simples |
| 1,234.56 ou 1.234,56 | 1234.56 | As duas convenções de separadores são entendidas; "Formato numérico" permite forçar uma |
| (1,234.50) | -1234.5 | Parênteses contábeis significam negativo |
| TRUE, FALSE, true, false | true, false (booleanos) | O que planilhas e código escrevem |
| 007 ou 00123 | "007" ou "00123" (texto) | Zeros à esquerda não podem ser recuperados depois de removidos |
| 12345678901234567890 | Continua texto | Com mais de quinze dígitos significativos, como número seria arredondado |
| +15551234567 | Continua texto | Um telefone, não uma quantidade |
| 2024-01-15 | "2024-01-15" (texto) | JSON não tem tipo de data, então o texto do arquivo é mantido |
| R$ 50 ou 12% | Continua texto | O símbolo tem significado |
Células vazias viram null por padrão. "Células vazias" permite escolher uma string vazia ou deixar a chave fora do registro. Nas formas em arrays, omitir um valor deslocaria todas as colunas seguintes, então ali uma célula vazia continua null. Se uma coluna é mista, por exemplo uma coluna quase numérica com algum "N/A" solto, a lista de Colunas a mostra como mista e deixa você forçá-la para Texto, Número ou Booleano.
Delimitadores, aspas e quebras de linha dentro das células
A vírgula é só o separador mais comum. O Excel, em muitas configurações regionais, grava ponto e vírgula, porque ali a vírgula é o separador decimal, como no Brasil. Há também exportações com tabulação (.tsv) e barra vertical (.psv). A detecção automática compara vírgula, ponto e vírgula, tabulação e barra verificando qual delas deixa todas as linhas com a mesma largura, em vez de contar caracteres, então vírgulas dentro de um endereço entre aspas não a enganam. Se a pré-visualização mostrar tudo numa coluna só ou uma divisão estranha, defina o "Delimitador" manualmente.
Uma célula que contém o delimitador ou uma quebra de linha precisa estar entre aspas duplas, e uma aspa dentro dela é duplicada. O conversor segue essas regras: uma célula como "Smith, John" continua sendo um único valor e uma anotação de várias linhas permanece numa só célula. "Caractere de aspas" pode ser ajustado para simples ou nenhuma, para o arquivo ocasional que não segue o padrão; uma aspa só abre um campo no início do campo, o que mantém intacto um nome como O'Brien.
Codificações do Excel
Se os acentos viram caracteres estranhos, o arquivo foi lido com a codificação errada. Automático lê primeiro a marca de ordem de bytes, depois verifica se o UTF-8 é válido e, por fim, recorre ao Windows-1252, que é o que o Excel grava num Windows ocidental para um CSV comum. Uma exportação "Texto Unicode" do Excel é UTF-16, que a ferramenta lê corretamente se você escolher UTF-16LE ou se o próprio arquivo se declarar assim. Você também pode forçar UTF-8, UTF-16BE ou ISO-8859-1. Se um arquivo declara a própria codificação, ela prevalece sobre a lista suspensa e a ferramenta avisa. Mais sobre como o Excel salva arquivos em abrir CSV no Excel corretamente.
| Sintoma | Causa provável | Solução |
|---|---|---|
| é aparece como é | Arquivo UTF-8 lido como Windows-1252 | Defina a Codificação como UTF-8 |
| Aspas curvas e o sinal do euro viram quadrados | Arquivo Windows-1252 lido como UTF-8 | Defina a Codificação como Windows-1252 |
| Letras espaçadas ou caracteres nulos | Arquivo UTF-16 lido como codificação de um byte | Defina a Codificação como UTF-16LE ou Automático |
| A linha inteira numa só célula | Delimitador errado | Defina o Delimitador como Ponto e vírgula ou Tabulação |
| Primeira chave estranha | Marca de ordem de bytes dentro da chave | Tratado automaticamente em UTF-8 |
Limites de tamanho e como conferir o resultado
A conversão gratuita aceita um arquivo por vez de até 25 MB, que é uma exportação de planilha muito grande, sem nenhum recurso restrito. Lembre que o JSON é maior que o CSV de origem, porque cada linha repete todas as chaves. Formatar com 2 espaços, 4 espaços ou tabulação aumenta mais ainda, então escolha "Minificado" em Indentação quando o tamanho importar. O Pro acrescenta a conversão de até 50 arquivos, o download em um único ZIP e a combinação de todos os arquivos em um só array ou em um só arquivo JSON Lines.
Cole o resultado no formatador de JSON se quiser inspecioná-lo ou validá-lo, e use JSON para CSV para fazer o caminho contrário; o guia de JSON para CSV cobre essa direção.
Perguntas frequentes
Como converto um arquivo CSV para JSON?
Solte o arquivo no conversor de CSV para JSON, deixe ativada "A primeira linha é o cabeçalho", escolha Array de objetos e clique em Converter para JSON. Depois copie o resultado ou baixe o arquivo .json. A conversão gratuita aceita um arquivo de até 25 MB.
Como converto um arquivo do Excel para JSON?
No Excel, use Salvar como e escolha CSV (ou Texto Unicode para um arquivo UTF-16); depois converta esse CSV. Só a planilha ativa é salva num CSV, então repita os passos para cada planilha de que precisar.
Por que meus números ou zeros à esquerda mudam?
Eles não mudam: valores como 007, números de identificação longos, telefones com sinal de mais, datas e valores com símbolos continuam como texto de propósito. Números simples viram números JSON. Você também pode desativar "Ler números, booleanos e null" para manter todos os valores como texto.
Por que os acentos ou símbolos aparecem errados?
O arquivo foi decodificado com a codificação errada. Mude a Codificação para UTF-8 ou Windows-1252 e acompanhe a pré-visualização; arquivos do Excel salvos em configuração ocidental costumam ser Windows-1252.
Por que tudo aparece numa coluna só?
O delimitador não é a vírgula. Defina o Delimitador como Ponto e vírgula, Tabulação ou Barra. O Excel, em muitas configurações regionais, salva com ponto e vírgula.
Meu CSV é enviado para algum lugar?
Não. O arquivo é lido e convertido no seu dispositivo, não nos nossos servidores, e o resultado vai direto para a área de transferência ou para um download.