logo
GeekFormat

CSV para JSON

Conversor online CSV para JSON do GeekFormat, converte rapidamente dados tabulares CSV (Comma-Separated Values) em array JSON padrão, adequado para integração de APIs, migração de dados, preparação de dados de teste frontend. Principais características: ① Reconhecimento automático de delimitador: detecta inteligente vírgula, ponto e vírgula (comum na Europa), tabulação (TSV) e unifica para vírgula; ② Reconhecimento de cabeçalho primeira linha: primeira linha automaticamente como chaves (Keys) de objetos JSON, cada linha subsequente convertida em objeto JSON; ③ Correção inteligente: incompatibilidade de colunas preenche valores vazios ou trunca automaticamente, aspas não fechadas completam automaticamente, corrige problemas de formato com um clique antes da conversão; ④ Análise padrão RFC 4180: trata corretamente campos entre aspas duplas, vírgulas dentro de aspas, escape de aspas duplas (""→"); ⑤ Saída em dois modos: suporta JSON bonito com indentação de 2 espaços (fácil leitura e depuração) e modo compacto (tamanho reduzido para produção); ⑥ Conversão em tempo real com debounce de 400ms, resultado instantâneo ao digitar; ⑦ Suporta upload de arquivos .csv/.txt, download de converted.json com um clique, painéis ajustáveis lateralmente, histórico local salvo automaticamente, alternância por abas no mobile, após conversão vai direto para a ferramenta de formatação JSON para continuar processando, toda análise e conversão feita localmente no navegador sem upload de dados.

Sugestões Relacionadas

Casos de uso

  • Desenvolvedores frontend ao integrar APIs convertem CSV de dados de teste exportado do Excel em array JSON como dados fictícios (mock data)
  • Desenvolvedores backend antes de importar dados convertem CSV para JSON para verificar se o mapeamento de campos está correto
  • Durante migração de dados convertem dados em formato CSV em JSON para usar em bancos de dados orientados a documentos como MongoDB
  • Geração em lote de dados de teste: edite casos de teste no Excel, converta para JSON e importe diretamente para framework de teste
  • Profissionais de SEO convertem CSV de lista de palavras-chave/URL em dados estruturados JSON-LD
  • Produto/Operações após exportar dados de planilha convertem para JSON para desenvolvedores fazerem arquivo de configuração
  • Processam CSV separado por ponto e vírgula enviado por clientes/colegas europeus, não precisa substituir ponto e vírgula por vírgula manualmente
  • Dados em formato CSV capturados por web scraping são convertidos rapidamente para JSON para facilitar processamento posterior
  • Antes de análise de dados convertem CSV para JSON para carregar e usar em JavaScript/Python
  • Em documentação de API convertem dados de exemplo CSV em exemplo JSON para facilitar comparação frontend-backend
  • Ao aprender formatos CSV e JSON observam intuitivamente a correspondência entre os dois formatos de dados
  • Antes de importar dados para plataformas low-code/no-code convertem CSV para formato JSON exigido pela plataforma

Recursos

  • Reconhecimento inteligente de delimitador: detecta automaticamente três delimitadores comuns vírgula(,), ponto e vírgula(;), tabulação(\t) e unifica para separação por vírgula padrão, CSV com ponto e vírgula exportado do Excel europeu ou arquivos TSV são reconhecidos ao colar
  • Análise padrão RFC 4180: trata corretamente campos com aspas (campos contendo vírgula, quebra de linha), escape de aspas duplas ("" dentro do campo é convertido para "), em conformidade com a especificação oficial CSV sem erros de análise
  • Reconhecimento automático de cabeçalho: primeira linha automaticamente como chave de objeto JSON (Key), cada linha de dados convertida em um objeto JSON, saída em formato de array JSON padrão
  • Correção inteligente de erros: incompatibilidade de colunas preenche colunas vazias ou trunca colunas excedentes automaticamente, aspas não fechadas completam automaticamente, corrige erros comuns de formato CSV com um clique
  • Localização precisa de erros: erros de análise exibem número da linha e conteúdo do erro linha por linha (incompatibilidade de colunas, problemas de aspas), área amarela de aviso lista todas as linhas com aviso para facilitar investigação
  • Modo duplo bonito/compacto: saída bonita com indentação de 2 espaços e hierarquia clara para leitura e depuração, saída compacta sem espaços em branco com tamanho reduzido para ambiente de produção
  • Conversão em tempo real com debounce de 400ms: conversão automática após digitar sem precisar clicar em botão, colar arquivos grandes rapidamente também não causa travamento
  • Upload e download de arquivos: suporta upload de arquivos .csv e .txt para leitura direta do conteúdo, resultado da conversão baixado como arquivo converted.json com um clique
  • Dados de exemplo integrados: clique no botão「Exemplo」para carregar amostra CSV pré-configurada, experimentar a funcionalidade rapidamente ou referenciar o formato
  • Salvamento automático de histórico local: salva automaticamente conteúdo de entrada recente em localStorage, na próxima abertura recupera automaticamente os dados da última vez sem precisar colar novamente
  • Largura ajustável dos painéis: no PC arraste a divisória central para ajustar livremente a proporção de largura dos painéis esquerdo e direito, conteúdo longo fica mais confortável em tela grande
  • Ir para formatação JSON com um clique: após concluir a conversão clique no botão para ir diretamente à ferramenta de formatação JSON para continuar processando o resultado, sem necessidade de copiar e colar manualmente
  • Adaptação para mobile: no celular entrada e saída alternam por abas, amigável ao toque, faça conversões a qualquer momento fora de casa para depuração
  • Processamento totalmente local no navegador: toda análise CSV e conversão JSON é feita em JavaScript local, dados não são enviados ao servidor, dados de negócios sensíveis podem ser usados com segurança

Como Usar

  1. Cole os dados CSV no editor esquerdo, ou clique em「Importar」para fazer upload de arquivo .csv/.txt, ou clique em「Exemplo」para carregar dados de amostra
  2. A ferramenta com debounce de 400ms reconhece automaticamente o delimitador e converte, o lado direito exibe resultado JSON em tempo real
  3. Se houver incompatibilidade de colunas ou erro de aspas, aparecerá área amarela de aviso, você pode clicar em「Corrigir estrutura」para corrigir automaticamente com um clique
  4. Conforme necessário alterne a chave「Saída bonita」(indentação/compacto), após ficar satisfeito com o resultado clique em「Copiar」ou「Exportar」para baixar arquivo JSON, também pode clicar no botão para ir à ferramenta de formatação JSON para processar posteriormente

Perguntas frequentes

Quais delimitadores CSV são suportados?

Reconhece automaticamente os três delimitadores mais comuns: vírgula(,) — padrão CSV padrão; ponto e vírgula(;) — delimitador comum do Excel europeu (porque a Europa usa vírgula como separador decimal); tabulação(\t) — formato de arquivo TSV. Após colar a ferramenta detecta automaticamente qual delimitador usar, unifica para separação por vírgula padrão antes de analisar.

E se um campo contiver vírgula ou quebra de linha?

A ferramenta segue o padrão CSV RFC 4180: se o conteúdo do campo contiver vírgula, quebra de linha ou aspas, coloque o campo entre aspas duplas (como "Smith, John"), aspas duplas dentro do campo precisam ser escapadas com duas aspas duplas (como "He said ""Hello"""). O parser consegue tratar corretamente esses casos, não confundirá vírgulas dentro do campo com delimitadores.

A primeira linha deve ser obrigatoriamente o cabeçalho?

Sim, a ferramenta considera por padrão a primeira linha como cabeçalho (nomes das colunas), que automaticamente vira nome de chave dos objetos JSON. Se seu CSV não tem cabeçalho, você pode adicionar manualmente nomes de colunas na primeira linha (como col1,col2,col3) e ajustar depois da conversão.

O que é o erro「incompatibilidade de colunas」?

CSV exige que cada linha tenha o mesmo número de colunas que o cabeçalho, se uma linha tiver mais ou menos campos separados por vírgula que o cabeçalho aparecerá esse erro. A ferramenta trata automaticamente: faltando colunas preenche com string vazia, colunas excedentes são truncadas, e lista todos os números de linha com problema na área amarela de aviso, você também pode clicar no botão「Corrigir estrutura」para corrigir automaticamente com um clique.

O que significa「aspas não fechadas」?

No padrão RFC campos entre aspas duplas devem ter abertura e fechamento, se uma linha tiver número ímpar de aspas significa que há aspas não fechadas (pode ter truncado ao copiar), a ferramenta ao detectar tenta completar automaticamente uma aspa no final e lista o número da linha com problema.

Consegue converter CSV exportado do Excel?

Sim. CSV exportado do Excel (incluindo versões Windows e Mac), bem como CSV separado por ponto e vírgula exportado do Excel europeu são todos reconhecidos e analisados corretamente. Observe que ao exportar do Excel escolha o formato「CSV UTF-8」para evitar caracteres quebrados em chinês, a ferramenta suporta perfeitamente codificação UTF-8.

Arquivos TSV (separados por tabulação) são suportados?

Sim. Basta colar conteúdo separado por tabulação ou fazer upload de arquivos .tsv/.txt, a ferramenta detecta automaticamente separação por tabulação e converte para vírgula padrão antes de analisar, não precisa substituir manualmente.

Qual é o formato do JSON resultante da conversão?

Saída em formato array JSON padrão, cada elemento do array é um objeto JSON, nomes de chave vêm do cabeçalho da primeira linha do CSV, valores vêm dos valores string da coluna correspondente. Por exemplo name,age\nJohn,25 é convertido para [{"name":"John","age":"25"}]. Observe que todos os valores são do tipo string, se precisar de tipo numérico você precisa converter no código.

Por que todos os valores são string? Consegue retornar tipo número/booleano?

O formato CSV por si só não tem informação de tipo, todos os campos são texto, por segurança a ferramenta converte tudo para string por padrão para evitar erro de julgamento de tipo (por exemplo código 00123 convertido para número vira 123 perdendo zeros à esquerda). Se precisar de conversão de tipo, você pode tratar no código após obter o JSON, ou usar a ferramenta de formatação JSON para processar posteriormente.

Posso enviar arquivos? Quais formatos são suportados?

Suporta upload de arquivos em formato .csv e .txt, clique no botão de upload para selecionar arquivo ou arraste para a área de entrada, o conteúdo do arquivo é lido na caixa de entrada e convertido automaticamente. O arquivo é lido localmente no navegador, não é enviado ao servidor.

Como verificar rapidamente se o JSON está correto após a conversão?

Após conversão bem-sucedida a barra de status exibe o número de linhas convertidas com sucesso; além disso, há botão para ir para「Formatação JSON」com um clique, clique para abrir diretamente a ferramenta de formatação JSON em nova aba com o resultado da conversão, para verificar e formatar posteriormente.

Consegue processar arquivos CSV de qual tamanho?

Processamento puramente frontend é totalmente suficiente para cenários de desenvolvimento diários até dezenas de milhares de linhas (centenas de KB a alguns MB). Arquivos muito grandes (dezenas de MB ou mais, nível de milhões de linhas) recomenda-se usar ferramentas profissionais de processamento de dados, mas cenários de desenvolvimento como depuração de API, preparação de dados, conversão em lote funcionam perfeitamente.

Caracteres chineses ou especiais ficarão quebrados?

Não. A ferramenta processa texto em codificação UTF-8, suporta perfeitamente chinês, japonês, emojis e outros caracteres Unicode. Se aparecer caracteres quebrados ao ler de arquivo, confirme que o arquivo foi salvo em codificação UTF-8 (exportação do Excel escolha「CSV UTF-8」).

Por que o conteúdo que colei anteriormente ainda está lá na próxima vez?

A ferramenta salva automaticamente o conteúdo CSV que você digitou no armazenamento localStorage do navegador, na próxima abertura da página recupera automaticamente a última entrada, não precisa colar novamente toda vez. Isso é armazenamento puramente local, os dados não são enviados, pode usar com segurança; clique no botão limpar para apagar o conteúdo atual.

Os dados são enviados ao servidor?

Não. Toda análise CSV, correção de erros, conversão JSON é feita totalmente em JavaScript local no seu navegador, os dados CSV digitados e o resultado da conversão não são enviados pela rede para nenhum servidor, arquivos CSV contendo dados de negócios sensíveis, dados internos podem ser convertidos com segurança.

Sobre Formato CSV e Conversão para JSON

CSV (Comma-Separated Values, Valores Separados por Vírgula) é o formato de texto de dados tabulares mais universal, quase todos os softwares de planilha (Excel, Google Sheets, Numbers, WPS) suportam importar e exportar CSV, também é um dos formatos mais usados para troca de dados, importação e exportação em lote. JSON (JavaScript Object Notation) é o formato de troca de dados mais usado em APIs Web e programação moderna. Converter CSV para JSON é uma necessidade muito frequente no desenvolvimento: ao receber CSV exportado do Excel de Produto/Operações precisa converter para JSON para API, ao exportar CSV do banco de dados precisa converter para JSON como dados fictícios, durante migração de dados CSV precisa ser importado para bancos de dados documentos como MongoDB… uma boa ferramenta de conversão economiza muito tempo de montar JSON manualmente.

CSV parece simples — campos separados por vírgula, linhas separadas por quebra de linha — mas na verdade há muitas pegadinhas: e se um campo contiver vírgula? E se um campo tiver quebra de linha? Como escapar aspas? CSV exportado por diferentes países também pode usar ponto e vírgula como delimitador (na Europa porque vírgula é separador decimal), usar tabulação (formato TSV). Se não tratar bem esses problemas os dados analisados ficarão errados. Esta ferramenta implementa o parser seguindo o padrão CSV RFC 4180, tratando corretamente casos limítrofes como campos entre aspas, escape de aspas duplas, vírgula/quebra de linha dentro de campo, não é um simples string.split(','), resultado preciso e confiável.

Reconhecimento automático de delimitador é uma funcionalidade muito prática. Muitos desenvolvedores ao pegar um arquivo CSV a primeira reação é usar split(','), mas exportação padrão do Excel europeu usa ponto e vírgula(;) como delimitador, split direto por vírgula trataria a linha inteira como um campo; arquivos TSV são separados por tabulação, split por vírgula é completamente errado. A ferramenta conta as ocorrências de vírgula, ponto e vírgula e tabulação em cada linha, julga automaticamente o delimitador mais provável e unifica a conversão, você não precisa se preocupar com a origem do arquivo, basta colar.

Correção inteligente de erros é a funcionalidade central que diferencia de ferramentas online simples. No trabalho prático os CSV recebidos muitas vezes não são padronizados: algumas linhas têm número errado de colunas (truncou ao copiar e colar, vírgula extra no meio), algumas têm aspas não fechadas (problema de exportação), algumas misturam delimitadores, analisar diretamente falharia ou daria resultado errado. A ferramenta ao encontrar esses problemas não recusa converter diretamente, mas sim: ① lista todos os números de linha com problema e motivo do erro; ② fornece botão de correção com um clique para preencher colunas vazias/truncar/completar aspas automaticamente; ③ mesmo com avisos tenta retornar resultado JSON utilizável, não falha a conversão inteira do arquivo por erro em uma linha.

Saída em modo duplo bonito/compacto atende a diferentes cenários de uso: durante depuração, leitura e visualização use modo bonito — indentação de 2 espaços, hierarquia clara, vê-se de imediato a estrutura do objeto; para ambiente de produção, retorno de API, arquivo de configuração use modo compacto — remove todos os espaços e quebras de linha, tamanho menor e transmissão mais rápida. Alternar a chave rerenderiza imediatamente, não precisa reconverter.

Por que processamento totalmente local é importante? Arquivos CSV frequentemente contêm dados reais de negócios, informações de clientes, dados de produto não publicados e outros conteúdos sensíveis, se enviar para servidor de conversão de terceiro há risco de vazamento de dados. Nesta ferramenta toda lógica de análise e conversão executa em JavaScript local no navegador, o arquivo só é processado na memória do seu computador, não há requisições de rede, funciona offline também, resolve fundamentalmente o problema de segurança de dados. Processamento local também tem vantagem de velocidade — arquivos de poucos MB são convertidos instantaneamente, sem esperar upload/download.

Painel divisório arrastável e histórico local são detalhes otimizados para uso frequente: ao processar tabelas largas você pode aumentar a área de entrada, ao focar no resultado aumentar a área de saída; CSV não terminado da última vez é recuperado automaticamente ao abrir novamente, não precisa procurar arquivo no e-mail/histórico de chat para copiar e colar. Ir diretamente para a ferramenta de formatação JSON com um clique ainda mais considera o fluxo de trabalho real — após converter JSON geralmente precisa formatar, validar, compactar, ir direto sem copiar e colar novamente ou abrir nova página.

É importante observar: ① Todos os valores CSV são convertidos para tipo string por padrão, isso é deliberado — CSV não tem informação de tipo, converter automaticamente para número/booleano pode dar erro (como CEP 00123, números de RG que perdem zeros à esquerda), se precisar de conversão de tipo trate no código; ② Atualmente suporta apenas conversão unidirecional CSV→JSON, para JSON→CSV use a ferramenta correspondente deste site; ③ Arquivos muito grandes (>10MB, milhões de linhas) recomenda-se usar ferramentas de linha de comando (como csvtojson, jq), esta ferramenta é voltada para cenários de depuração de desenvolvimento, funciona perfeitamente até dezenas de milhares de linhas no uso diário.

术语表

CSV
Comma-Separated Values (Valores Separados por Vírgula), formato que armazena dados tabulares em texto puro, cada linha um registro, campos separados por vírgula, é o formato mais universal de importação e exportação para planilhas e bancos de dados.
RFC 4180
Documento padrão formal do formato CSV, define regras como campos entre aspas, escape de aspas duplas, tratamento de quebra de linha, esta ferramenta segue esse padrão para análise.
TSV
Tab-Separated Values (Valores Separados por Tabulação), formato que usa Tab(\t) em vez de vírgula para separar campos, esta ferramenta reconhece e suporta automaticamente.
Reconhecimento automático de delimitador
A ferramenta detecta automaticamente se o arquivo usa vírgula, ponto e vírgula ou tabulação como delimitador, sem necessidade de usuário selecionar manualmente, mais conveniente para processar CSV de diferentes origens.
Cabeçalho (Header)
Primeira linha do CSV, contendo nomes de cada coluna, após conversão vira nome de chave (Key) dos objetos JSON.
Array JSON
Formato de saída desta ferramenta, lista de objetos JSON entre colchetes e separados por vírgula, cada objeto corresponde a uma linha de dados no CSV.
Escape de aspas duplas
No padrão RFC, aspas duplas dentro de campo são representadas por duas aspas duplas consecutivas (""), durante análise restauradas para uma única aspa dupla.
Incompatibilidade de colunas
Erro onde o número de campos de uma linha não corresponde ao número de campos do cabeçalho, a ferramenta preenche valores vazios ou trunca automaticamente e marca com aviso.
Debounce
Após entrada espera 400ms sem nova entrada antes de executar conversão, evita reanalisar arquivo grande a cada tecla causando travamento.
Saída bonita (Pretty Print)
Formato JSON com indentação e quebras de linha, hierarquia clara para leitura e depuração humana.
Saída compacta (Minify)
Formato JSON sem espaços em branco nem quebras de linha, tamanho mínimo adequado para transmissão e ambiente de produção.
localStorage
Armazenamento local do navegador, a ferramenta usa para salvar automaticamente o conteúdo da última entrada, os dados existem apenas localmente no usuário sem envio ao servidor.

Comparação de delimitadores CSV por região

Diferenças de delimitador CSV de exportação padrão do Excel por país/região:

Região/IdiomaDelimitador padrãoSeparador decimalSuporte da ferramenta
EUA/Reino Unido/China/JapãoVírgula ,Ponto .
Alemanha/França/Itália/EspanhaPonto e vírgula ;Vírgula ,✅ Reconhecimento automático
Formato TSV genéricoTabulação \t-✅ Reconhecimento automático

Exemplo de conversão CSV para JSON

Comparação de formato de entrada e saída:

Conteúdo
Entrada CSVname,age,city\nJohn,25,New York\nJane,30,London
Saída JSON[{"name":"John","age":"25","city":"New York"},{"name":"Jane","age":"30","city":"London"}]

Erros comuns e correção

Problemas comuns na análise CSV e tratamento:

Tipo de erroCausaTratamento de correção automática
Incompatibilidade de colunas (poucas colunas)Número insuficiente de delimitadores em uma linha, número de campos menor que cabeçalhoPreenche automaticamente com string vazia no final
Incompatibilidade de colunas (muitas colunas)Vírgulas extras ou aspas não bem delimitadas em uma linhaTrunca campos excedentes automaticamente
Aspas não fechadasNúmero ímpar de aspas, campo não terminou corretamenteCompleta automaticamente uma aspa dupla no final da linha
Delimitador erradoArquivo usa ponto e vírgula ou tabulação em vez de vírgulaReconhece automaticamente e substitui unificadamente por vírgula

Privacy & Security

Nesta ferramenta de CSV para JSON, toda análise CSV, reconhecimento de delimitador, correção de erros, conversão JSON e leitura de arquivos são feitos totalmente no seu navegador local através de JavaScript, o conteúdo CSV que você cola e os dados do arquivo enviado não são enviados para nenhum servidor, nem são registrados, armazenados ou analisados. O histórico local é salvo apenas no localStorage do seu próprio navegador, fechar ou limpar dados do navegador apaga. Arquivos CSV contendo dados de negócios sensíveis, informações de clientes, dados internos podem ser usados com segurança, não há risco de vazamento de dados.

Authoritative References

Troubleshooting

E se aparecerem caracteres quebrados em chinês?

Caracteres quebrados geralmente são problema de codificação do arquivo. Certifique-se que o arquivo CSV foi salvo em codificação UTF-8: ao exportar do Excel escolha o formato「CSV UTF-8 (separado por vírgula)」, em vez de「CSV (separado por vírgula)」comum (este é codificação GBK em sistema Windows chinês). Se o arquivo for codificação GBK, você pode abrir com Bloco de Notas e salvar como UTF-8 antes de fazer upload.

Após conversão todo o conteúdo virou uma única coluna?

Significa que a ferramenta não reconheceu corretamente o delimitador. Verifique qual delimitador seu CSV usa para separar campos — Excel europeu usa ponto e vírgula(;) por padrão, esta ferramenta suporta reconhecimento automático; se for outro delimitador especial (como pipe |), você pode substituir por vírgula primeiro no editor antes de converter.

Por que números viraram string?

Isso é normal. O formato CSV por si só não carrega informação de tipo, todos os campos são texto. Se converter automaticamente campos que parecem números para tipo Number, causará perda de zeros à esquerda (como 00123 vira 123), perda de precisão em números longos (como número de pedido com mais de 15 dígitos) e outros problemas. Se precisar de tipo numérico, converta por conta própria no código.

Após colar arquivo grande o navegador trava?

A ferramenta tem otimização de debounce de 400ms, mas se for um CSV muito grande de centenas de milhares de linhas (acima de 10MB), o processamento pelo navegador ainda terá pressão. Recomenda-se: ① Primeiro recorte a parte necessária no Excel/VS Code antes de converter; ② Arquivos muito grandes são mais adequados para ferramentas de linha de comando como csvtojson, jq, Python pandas. Cenários de desenvolvimento diário (poucos milhares a dezenas de milhares de linhas) funcionam perfeitamente.