IA no seu dispositivo — profissional e privado.

Documentos

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

1

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.

2

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.

3

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.

4

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 JSON

A 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ídaAparênciaUse 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 LinesUm registro por linha, sem colchetesImportaçõ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 CSVNo JSONPor quê
42 ou 3,1442 ou 3,14 (números)Números simples
1,234.56 ou 1.234,561234.56As duas convenções de separadores são entendidas; "Formato numérico" permite forçar uma
(1,234.50)-1234.5Parênteses contábeis significam negativo
TRUE, FALSE, true, falsetrue, 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
12345678901234567890Continua textoCom mais de quinze dígitos significativos, como número seria arredondado
+15551234567Continua textoUm 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 textoO 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.

SintomaCausa provávelSolução
é aparece como éArquivo UTF-8 lido como Windows-1252Defina a Codificação como UTF-8
Aspas curvas e o sinal do euro viram quadradosArquivo Windows-1252 lido como UTF-8Defina a Codificação como Windows-1252
Letras espaçadas ou caracteres nulosArquivo UTF-16 lido como codificação de um byteDefina a Codificação como UTF-16LE ou Automático
A linha inteira numa só célulaDelimitador erradoDefina o Delimitador como Ponto e vírgula ou Tabulação
Primeira chave estranhaMarca de ordem de bytes dentro da chaveTratado 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.

Continue lendo

Mais sobre Documentos →