Converter CSV em JSON Comma-Separated Values ↔ JavaScript Object Notation Grátis Online Seguro
Solte um arquivo CSV e leve JSON. É lido e escrito aqui, no seu navegador, por isso o arquivo não sai do seu aparelho — e o que a conversão mantém, e o que não consegue, está escrito mais abaixo em vez de ficar para descobrir.
Converta o seu arquivo
Solte aqui um arquivo CSV, ou escolha um.
O seu arquivo não sai deste dispositivo. Tudo roda no seu navegador.
Nada é enviado
Converter a partir de CSV
Converter para CSV
De onde vêm estes formatos
O CSV é o mais antigo e o menos normalizado: uma tabela escrita em linhas de texto, em uso desde os anos setenta e só descrito por escrito em 2005, quando cada programa já decidira por si qual era o delimitador e quando pôr aspas. O XML saiu do SGML em 1998, para documentos que têm de levar estrutura estrita e ser verificados contra um esquema. O JSON foi retirado do JavaScript por Douglas Crockford por volta de 2001, reduzido de propósito a objetos, listas, números e cadeias — e esse despojamento é a razão de ter conquistado a web. O YAML é o seu primo legível, onde a indentação faz o trabalho que em outros lugares cabe às chavetas. Ao converter entre eles só importa uma coisa: o CSV é plano, uma grelha de linhas e colunas, ao passo que JSON, XML e YAML são árvores.
Onde os encontra
O CSV é o que uma planilha exporta e o que lhe entregam um contabilista, uma plataforma de loja ou um extrato bancário. O JSON é o que os serviços web falam e aquilo em que cada vez mais se escrevem os arquivos de configuração. O XML sobrevive em sistemas empresariais antigos, nas normas de faturação e dentro dos próprios formatos de escritório. O YAML é onde as pessoas escrevem definições à mão. Converter entre eles é o trabalho diário de levar os dados de onde foram produzidos para onde são precisos.
Perguntas frequentes
O meu CSV abriu como uma única coluna no Excel. Porquê?
Porque a sua planilha esperava outro aba. O Excel segue o aba de listas das definições regionais, que é o ponto e vírgula em toda a parte onde a vírgula já é o sinal decimal — ou seja, em boa parte da Europa continental. Um arquivo separado por vírgulas aparece então como uma só coluna de texto. Use a caixa de importação e indique o aba, em vez de abrir o arquivo com duplo clique. A mesma definição regional explica que 3.5 chegue por vezes transformado em data.
Por que o meu JSON aninhado não dá uma planilha arrumada?
Porque uma planilha é plana e o JSON é uma árvore. Uma linha leva um valor por coluna; um objeto JSON pode conter uma lista dentro de um campo dentro de outra lista. Converter é escolher como achatar isso: ou juntar os nomes aninhados num cabeçalho de coluna comprido, ou repetir a linha-mãe uma vez por cada filha. Ambas são cedências, e nenhuma se desfaz automaticamente — por isso voltar da planilha à forma original costuma exigir uma decisão humana.
O arquivo perde qualidade?
Depende do que os dois formatos conseguem guardar. Converter entre formatos que armazenam a mesma coisa — um PNG para BMP, um WAV para FLAC — não perde nada. Converter para um formato que descarta informação para poupar espaço, como JPEG ou MP3, perde um pouco de cada vez, e voltar atrás não a traz de volta. Onde existe escolha, esta página tende a conservar a qualidade original em vez de fazer o arquivo menor.
O meu arquivo é enviado para algum lado?
Não. A conversão acontece dentro do seu navegador, na sua própria máquina; o arquivo nunca sai dela e aqui não existe servidor nenhum que o pudesse receber. É por isso que um arquivo grande é limitado pela sua memória e não por um envio, e que nada do que converter pode aparecer nos registros de quem quer que seja — incluindo os nossos. As ferramentas de áudio e de vídeo buscam, porém, o seu motor de conversão neste site da primeira vez que as usar — uns trinta megabytes, uma só vez; depois o trabalho continua a acontecer inteiramente na sua máquina.
Por que as pessoas convertem CSV em JSON
O CSV é o formato das planilhas e das exportações: uma tabela simples, uma linha por registro, células separadas por vírgulas ou pontos e vírgulas. Toda planilha consegue salvá-lo e todo banco de dados consegue produzi-lo. O JSON é o formato dos programas: um texto estruturado que serviços web, aplicativos e scripts leem diretamente. Quando uma tabela precisa alimentar um programa, um site, um aplicativo de celular, uma biblioteca de gráficos ou uma API, um CSV não é o que o programa quer. Ele quer JSON. É por isso que as pessoas convertem CSV em JSON: têm os dados em uma tabela, e o que vai usá-los fala JSON.
As situações são comuns. Um desenvolvedor com uma lista de produtos guardada em uma planilha, que uma página web deveria carregar. Uma designer com os dados de um gráfico. Um professor que tem notas em uma tabela e quer que um script as processe. Um lojista que precisa enviar um catálogo a um serviço que só aceita JSON. Em todos os casos a tabela já está em ordem, e o que falta é só a mudança de idioma.
Esta página converte CSV em JSON no seu navegador. Seu arquivo é lido e escrito aqui, então nunca sai do seu dispositivo, o que importa para listas de clientes, registros de alunos e qualquer outra coisa pessoal. E a página diz de antemão o que a travessia mantém e o que ela não consegue, em vez de deixar você descobrir sozinho. Abaixo você encontra como a conversão funciona, como os valores são tipados e o que observar quanto aos separadores.
Como a conversão funciona
A primeira linha dá as chaves
Seu CSV é lido dentro do seu navegador. A primeira linha é tomada como cabeçalho, e suas células viram as chaves. Cada outra linha vira um registro, um objeto em que cada chave é emparelhada com o valor da mesma coluna. O resultado é uma lista de registros, que é a forma que os programas esperam de uma tabela.
Os campos entre aspas são mantidos inteiros
O CSV tem armadilhas, e elas são tratadas. Os campos entre aspas mantêm suas vírgulas, suas quebras de linha e suas aspas duplicadas. Uma célula como "Silva, João" continua sendo um só valor, e uma célula que contém uma quebra de linha continua sendo um só valor também. Um arquivo que termina sem uma quebra de linha final ainda rende sua última linha, então nada se perde no fim.
Toda célula é mantida
Toda célula chega ao resultado. As células vazias são mantidas como valores vazios, de modo que cada registro tem as mesmas chaves e a estrutura é regular.
O que é mantido
Todas as linhas e todas as colunas
Toda célula é mantida, com a primeira linha como as chaves. Uma tabela de 300 linhas e 8 colunas dá uma lista de 300 registros com 8 chaves cada.
O texto de cada célula exatamente
O conteúdo de cada célula é mantido exatamente, inclusive os espaços dentro dela, as letras acentuadas e os símbolos. Nada é aparado, traduzido ou reformatado pelas suas costas.
Vírgulas, aspas e quebras de linha dentro das células
Os valores que contêm vírgulas, aspas ou quebras de linha sobrevivem intactos, porque as regras de aspas do CSV são seguidas ao ler o arquivo.
Como os valores são tipados
Uma célula de CSV é texto e nada mais
Uma célula de CSV é texto e nada mais. Ela não diz se é um número, uma data ou uma palavra. Então os tipos são lidos de volta por regra, e não por mágica: números simples, true, false e null são reconhecidos, e todo o resto continua sendo uma cadeia de texto. Uma célula que contém 42 vira o número 42, uma célula que contém true vira o valor true, e uma célula que contém Berlim continua sendo a cadeia Berlim.
Por que os zeros à esquerda sobrevivem
Como só os números simples são convertidos, um zero à esquerda, um número de telefone ou um identificador sobrevive intacto. Um CEP escrito 01234 não é um número simples, então continua sendo a cadeia 01234, e o zero não se perde. É uma proteção deliberada: transformar esses valores em números os danificaria em silêncio.
As datas continuam como texto
As datas não são adivinhadas. Uma célula que contém 2026-03-14 continua sendo a cadeia 2026-03-14. O JSON não tem tipo de data, então o programa receptor decidirá o que fazer com ela, e esse é o lugar mais seguro para a decisão.
O que você deve saber antes de converter CSV em JSON
O separador é adivinhado a partir da primeira linha
O separador é adivinhado a partir da primeira linha: vírgula ou ponto e vírgula, o que for mais frequente fora das aspas. Isso cobre os dois casos comuns, já que as planilhas de alguns países salvam com ponto e vírgula. Se o seu arquivo usa uma tabulação ou outro caractere, troque-o por uma vírgula primeiro.
O cabeçalho deve estar na primeira linha
A primeira linha vira as chaves, então confira se é o cabeçalho. Se o seu arquivo tem um título, uma linha em branco ou anotações acima da tabela, apague-os primeiro, ou as chaves ficarão erradas.
Nomes de colunas duplicados
Duas colunas com o mesmo nome não podem ser ambas chaves de um mesmo objeto, porque uma chave só pode aparecer uma vez. Dê a cada coluna um nome distinto antes de converter CSV em JSON.
Como converter CSV em JSON aqui
Adicione o seu arquivo
Solte o CSV na página ou escolha-o no seu dispositivo. Ele é lido dentro do seu navegador e não é enviado.
Converta
Aperte o botão. Um arquivo de tamanho comum leva um instante. Deixe a página aberta até terminar.
Baixe e confira
Baixe o JSON e abra-o em um editor de texto. Olhe o primeiro registro e o último, e confira se as chaves são os nomes que você espera e se os valores têm os tipos de que precisa.
Um olhar mais atento sobre CSV e JSON
Tabelas e árvores
O CSV descreve uma tabela: linhas e colunas, nada mais. O JSON descreve uma árvore: objetos que contêm valores, os quais por sua vez podem ser objetos ou listas. Uma tabela é o tipo mais simples de árvore, uma lista de registros que têm todos as mesmas chaves. Então a conversão de CSV em JSON é direta na estrutura, e as perguntas interessantes são sobre tipos, e é por isso que as regras acima importam.
Por que o JSON é mais fácil para programas
Um arquivo CSV é frágil: mude um separador ou um hábito de aspas e cada leitor pode discordar sobre como lê-lo. O JSON tem uma gramática estrita, uma ideia clara de cadeias, números, booleanos e null, e leitores prontos em toda linguagem de programação. Um programa que recebe JSON não precisa de adivinhação. É por isso que muitos serviços insistem nele.
Tamanho
O JSON repete os nomes das chaves em cada registro, então o arquivo é maior que o CSV de que veio. Para uma tabela de milhares de linhas, espere que o JSON seja consideravelmente maior. Esse é o preço de tornar cada registro autodescritivo.
Situações comuns em detalhe
Alimentando uma página web ou um aplicativo
Uma lista de produtos, locais ou eventos guardada em uma planilha pode ser convertida em JSON e carregada por uma página. Você edita a tabela na planilha que conhece e deixa a página ler o resultado.
Dados para gráficos e mapas
As bibliotecas de gráficos e mapas costumam aceitar JSON. Converta CSV em JSON, aponte a biblioteca para o arquivo e o gráfico se desenha sozinho a partir da sua tabela.
Envios a serviços e APIs
Os serviços que importam catálogos, contatos ou configurações muitas vezes aceitam só JSON. Uma planilha pode ser transformada no arquivo certo aqui e enviada.
Scripts e automação
Um script que processa registros fica mais simples quando lê JSON. Converter uma vez poupa você de escrever um leitor de CSV e de se preocupar com aspas.
Conselhos práticos antes de converter CSV em JSON
Arrume a linha de cabeçalho
Use nomes curtos, claros e únicos, sem espaços se o programa receptor preferir. Os nomes viram chaves, e os programas se referem às chaves pelo nome.
Remova anotações e totais
Uma planilha costuma ter um título acima da tabela ou uma linha de total abaixo. Apague-os antes de exportar o CSV, ou eles viram registros.
Confira o separador
Se a sua planilha salvou com ponto e vírgula, a página adivinha corretamente. Se a primeira linha contém vírgulas e pontos e vírgulas no texto, confira o resultado com cuidado.
Pense nos identificadores
Se uma coluna guarda códigos que parecem números mas devem continuar texto, como códigos com zeros à esquerda, as regras os protegem. Mas uma coluna de números simples de que você precise como texto chegará como números, então ajuste-a no programa que lê o JSON.
Perguntas que as pessoas fazem antes de converter
Por que alguns dos meus valores são números e outros cadeias?
Porque números simples, true, false e null são reconhecidos, e todo o resto continua sendo uma cadeia. Um zero à esquerda ou uma letra faz a célula virar uma cadeia.
Por que um zero no começo sobreviveu?
Por projeto. Só os números simples são convertidos, então um CEP ou um número de telefone mantém o zero.
O meu arquivo usa ponto e vírgula. Vai funcionar?
Sim. O separador é adivinhado a partir da primeira linha, vírgula ou ponto e vírgula, o que for mais frequente fora das aspas.
As datas são convertidas?
Não. O JSON não tem tipo de data, então uma data continua sendo o texto que era.
O meu arquivo é enviado?
Não. A conversão roda no seu navegador e o arquivo nunca sai do seu dispositivo.
Posso voltar para CSV?
Sim. JSON em CSV transforma uma lista de registros simples em uma tabela de novo.
Escolhendo com sabedoria ao converter CSV em JSON
JSON, XML ou YAML?
O JSON serve a programas e serviços web. Se um sistema espera marcação, JSON em XML pode vir em seguida. Para arquivos de configuração que as pessoas editam à mão, JSON em YAML se lê com mais conforto.
Origem em planilha
Se os seus dados estão em uma pasta de trabalho do Excel e não em um CSV, XLSX em JSON lê a pasta diretamente e trata várias planilhas.
Guarde a tabela
O CSV é o mestre para quem mantém os dados. Guarde-o e converta de novo quando mudar.
Obtendo um bom resultado depois da conversão
Valide o JSON em um visualizador
Abra o resultado em um editor que entenda JSON e recolha os registros. Se a estrutura se parece com o que você espera, está sólida.
Compare alguns registros com a origem
Pegue algumas linhas do meio e confira com a tabela. Leva um minuto e diz que a conversão é fiel.
Minifique para publicar
Se o arquivo vai ser carregado por uma página web e é grande, existem ferramentas que removem os espaços e o deixam mais leve. Os dados continuam os mesmos.
Preparando o seu CSV para converter bem
Salve com uma codificação padrão
As planilhas podem salvar CSV em vários conjuntos de caracteres. Escolha uma codificação Unicode para que letras acentuadas e símbolos cheguem corretamente, em especial se os seus dados incluem nomes em mais de um idioma.
Mantenha cada coluna em um só tipo de coisa
Quando você converte CSV em JSON, uma coluna que tem números na maioria das linhas e palavras em algumas produzirá uma mistura de tipos. Limpe as exceções para que cada coluna signifique uma coisa só.
Teste primeiro com um pedaço pequeno
Se o seu arquivo é grande, leve as primeiras vinte linhas para um arquivo de teste e converta esse. Uma olhada rápida no resultado mostra se as chaves e os tipos são os que você espera.
Usando o resultado depois de converter CSV em JSON
Carregando em uma página web
Depois que você converte CSV em JSON, uma página pode buscar o arquivo e transformá-lo em uma lista, uma tabela ou um conjunto de marcadores em um mapa com poucas linhas de script. Como o arquivo é texto simples, você pode hospedá-lo ao lado da página, e uma mudança nos dados precisa só de uma nova conversão e de um novo envio.
Conferindo números e cadeias
O programa que lê o JSON verá números onde a tabela tinha números simples e cadeias em todo o resto. Se uma coluna de valores tem uma palavra perdida em uma linha, essa linha trará uma cadeia, o que pode surpreender um cálculo. Uma rápida olhada na coluna da tabela antes de converter poupa uma caça ao erro depois.
Tratando células vazias
Uma célula vazia chega como um valor vazio para a sua chave. Os programas diferem na forma de tratar isso: alguns veem uma cadeia vazia, alguns veem nada. Se importa, decida no programa como ler os brancos, e não conte com a tabela para dizer.
Tabelas grandes
Uma tabela de muitos milhares de linhas dá um arquivo grande. Se uma página precisa carregá-lo, considere dividir os dados em páginas, ou carregar só a parte necessária, para que os visitantes não precisem esperar.
Privacidade e tratamento
Por que a conversão local importa para dados
Os arquivos de dados muitas vezes guardam o que é privado: clientes, alunos, endereços, preços. Muitos conversores on-line enviam o seu arquivo a um servidor, processam e devolvem o resultado, e por um tempo uma cópia vive em uma máquina que você não controla. Aqui o seu próprio navegador faz o trabalho, então os dados ficam no seu dispositivo.
O que acontece quando você sai
Quando você fecha a página, o arquivo convertido desaparece do navegador, então baixe-o antes. Nada sobre os seus dados é guardado.
Se algo der errado
As chaves estão erradas
A primeira linha não era o cabeçalho. Remova qualquer título ou linha em branco acima da tabela e converta de novo.
Todos os dados estão em uma chave só
O separador não era o que a página adivinhou, talvez uma tabulação. Troque-o por uma vírgula.
A página trava com um arquivo grande
Tudo roda no seu dispositivo, e um arquivo grande precisa de memória. Tente de novo em um computador, ou divida os dados.
Ferramentas relacionadas
A mesma família de ferramentas cobre os trabalhos vizinhos. Para voltar, use JSON em CSV. Para pastas de trabalho do Excel, XLSX em JSON e JSON em XLSX estão à mão. Para outros formatos de dados estruturados, há JSON em XML, XML em JSON, JSON em YAML e YAML em JSON. Quando os números estão em um PDF, PDF em XLS reconstrói uma tabela a partir da página.
Um exemplo resolvido
Digamos que você guarde uma lista de 120 lojas em uma planilha, com nome, cidade, CEP e telefone, e o seu site deva mostrá-las em um mapa. Você salva a planilha como CSV, solta-a aqui e aperta o botão. Um instante depois baixa um JSON com 120 registros. Os CEPs com zero à esquerda estão intactos, porque são cadeias. Você põe o arquivo ao lado da página, e a biblioteca do mapa o lê. Quando uma loja muda de endereço, você edita a planilha e converte de novo.
Uma lista de conferência curta
Antes de converter
Ponha o cabeçalho na primeira linha. Remova títulos e totais. Dê a cada coluna um nome único.
Durante a conversão
Fique na página até o arquivo ficar pronto.
Depois de converter
Abra o JSON, confira as chaves e alguns registros e guarde o CSV como seu mestre.
Erros comuns
Deixar um título acima do cabeçalho
A primeira linha vira as chaves. Um título ali as arruína.
Esperar que as datas sejam convertidas
As datas continuam texto. Deixe o programa receptor interpretá-las.
Apagar o CSV
Guarde-o. É a versão que você pode editar em uma planilha.
Seus dados ficam no seu dispositivo
A conversão acontece localmente. Seu arquivo é lido pelo seu próprio navegador, reescrito ali e devolvido como JSON. Nada é enviado, então nenhuma cópia vai parar em um servidor e ninguém mais pode lê-lo. Para dados de conteúdo privado, esse é o jeito seguro de converter CSV em JSON.
Resumo
Para converter CSV em JSON aqui, solte o arquivo e aperte o botão. Ele é lido e escrito no seu navegador, então o arquivo nunca sai do seu dispositivo. Toda célula é mantida, com a primeira linha como as chaves. Os campos entre aspas mantêm suas vírgulas, suas quebras de linha e suas aspas duplicadas, e um arquivo que termina sem uma quebra de linha ainda rende sua última linha. Uma célula de CSV é texto e nada mais, então os tipos são lidos de volta por regra, e não por mágica: números simples, true, false e null são reconhecidos, e todo o resto continua sendo uma cadeia, e é por isso que um zero à esquerda, um número de telefone ou um identificador sobrevive intacto. O separador é adivinhado a partir da primeira linha, vírgula ou ponto e vírgula, o que for mais frequente fora das aspas.