Converter CSV em JSON

TL;DR

O Conversor de CSV/JSON funciona inteiramente no teu navegador. Os teus dados são analisados e transformados localmente — não há upload nem processamento do lado do servidor. Alterna entre as direções CSV para JSON e JSON para CSV, escolhe um delimitador, configura o tratamento de cabeçalhos e lê um resumo de linhas e colunas antes de copiares ou descarregares o resultado.

A ferramenta lida com ambas as direções de conversão, deteta delimitadores automaticamente quando lhe pedes e reporta problemas (como linhas irregulares) como avisos em vez de descartar dados silenciosamente.

Porque converter no navegador

O CSV é a língua franca da exportação de dados — folhas de cálculo, bases de dados e APIs distribuem-no todos —, mas o código das aplicações quase sempre quer JSON. Converter no teu navegador significa que as linhas sensíveis (listas de clientes, exportações financeiras, registos) nunca tocam num servidor de terceiros. Significa também feedback imediato: muda um delimitador ou ativa um cabeçalho e a saída atualiza-se de imediato, com uma pré-visualização que podes analisar antes de te comprometeres.

Converter CSV em JSON

1. Abre o Conversor de CSV/JSON e seleciona o modo CSV para JSON.
2. Cola o teu CSV na área de origem.
3. Escolhe um Delimitador: Auto (a predefinição, que deteta o separador), Comma, Semicolon, Tab ou Pipe. Auto é útil quando não tens a certeza se uma exportação é delimitada por vírgulas ou por pontos e vírgulas.
4. Define as opções de CSV que moldam a saída:
   • Header — trata a primeira linha como nomes de campos para que o JSON use chaves de objeto em vez de índices de array.
   • Dynamic typing — converte valores numéricos e de aspeto booleano em números e booleanos reais em vez de os deixar como cadeias.
   • Skip empty lines — ignora linhas em branco em vez de emitir registos vazios.
   • Trim headers — remove espaços em branco dos nomes de cabeçalho para chaves de objeto mais limpas.
   • JSON Lines — emite um objeto JSON por linha (NDJSON) em vez de um único array JSON.
   • Minify — remove a indentação para produzir uma saída compacta.
5. Clica em converter e lê o resumo (linhas, colunas, o delimitador detetado, tamanho da saída) e a pré-visualização.

Quando a opção de cabeçalho está ativa, cada linha torna-se um objeto indexado pelos nomes de cabeçalho; quando está inativa, cada linha torna-se um array de valores. Linhas irregulares e outros problemas estruturais aparecem como avisos na lista de problemas em vez de fazerem falhar toda a conversão.

Converter JSON em CSV

1. Muda para o modo JSON para CSV.
2. Cola o teu JSON. A origem deve ser um array de objetos planos (ou valores que o conversor consiga aplanar) — formas profundamente aninhadas ou não tabulares são reportadas como não suportadas em vez de serem silenciosamente forçadas.
3. Escolhe um Delimitador: Comma, Semicolon, Tab ou Pipe. A deteção automática é uma funcionalidade de entrada CSV, pelo que não é oferecida ao gerar CSV.
4. Define as opções de JSON:
   • Header — escreve uma linha de cabeçalho a partir das chaves do objeto como primeira linha.
   • Minify — produz CSV compacto sem espaçamento extra.
5. Converte e revê o resumo e a pré-visualização.

O conversor reúne a união de chaves entre os objetos para o cabeçalho e escreve uma linha por objeto. JSON inválido é capturado e reportado com uma mensagem clara em vez de produzir um ficheiro meio escrito.

Trabalhar com ficheiros

Podes colar dados diretamente ou carregar um ficheiro. A ferramenta valida o ficheiro antes de o ler: tipos de ficheiro não suportados e ficheiros demasiado grandes são rejeitados previamente com uma mensagem explícita (unsupportedFile ou fileTooLarge), para que te apercebas imediatamente em vez de após uma análise parcial. Quando terminas, uma ação de descarregamento produz um ficheiro chamado igottools-csv-json-converter.json (ou .csv) para a direção atual.

Ler o resumo e a pré-visualização

Cada conversão bem-sucedida devolve um resumo e uma pré-visualização junto com a saída:

• Resumo — total de linhas, total de colunas, o delimitador realmente usado, contagem de erros e tamanho da saída em bytes.
• Pré-visualização — os cabeçalhos detetados e uma amostra das linhas convertidas, para que possas confirmar a estrutura antes de copiares ou descarregares.
• Problemas — quando a conversão tem sucesso com ressalvas (por exemplo, linhas irregulares ou valores forçados), aparecem como uma lista de avisos numerados por linha. Um sucesso puro não tem problemas; uma falha grave devolve um resultado inválido com uma chave de mensagem.

Limites e advertências honestas

• Dados planos funcionam melhor. O conversor é feito para dados tabulares: arrays de registos planos. JSON profundamente aninhado ou objetos não uniformes podem ser reportados como uma forma não suportada em vez de serem aplanados heuristicamente.
• A deteção automática é apenas para entrada CSV. Ao gerar CSV tens de escolher um delimitador concreto; Auto não está disponível nessa direção.
• O tamanho do ficheiro é limitado. Ficheiros demasiado grandes são rejeitados antes da análise. Para conjuntos de dados muito grandes, divide a entrada ou usa um pipeline offline dedicado.
• A tipagem dinâmica é opcional. Por predefinição os valores ficam como cadeias para que vejas exatamente o que estava na origem. Ativa a tipagem dinâmica apenas quando confias que os dados sejam consistentemente numéricos ou booleanos.
• Sem persistência. O conversor não se lembra da tua entrada nem da tua saída. Atualiza a página e tudo é limpo — a predefinição segura para dados sensíveis.

Ferramentas relacionadas

• Formatador JSON — formata de forma bonita, valida e explora o JSON que acabaste de produzir. Consulta /pt/tools/dev/json-formatter/.
• Testador de JSONPath — consulta o JSON convertido com expressões JSONPath para extrair as linhas de que precisas. Consulta /pt/tools/dev/jsonpath-tester/.
• JSON para TypeScript — gera tipos TypeScript a partir do JSON convertido para o teu código de aplicação. Consulta /pt/tools/dev/json-to-typescript/.

Perguntas frequentes

Os meus dados são enviados para algum lado?

Não. A conversão é executada inteiramente no teu navegador. O teu CSV, o teu JSON e qualquer ficheiro carregado são analisados e transformados localmente e nunca enviados para um servidor.

Que delimitadores posso usar?

Para entrada CSV: Auto, Comma, Semicolon, Tab ou Pipe. Para saída de JSON para CSV: Comma, Semicolon, Tab ou Pipe (a deteção automática não é oferecida quando estás a gerar CSV).

O que faz a opção Header?

Em CSV para JSON trata a primeira linha como nomes de campos, de modo que cada registo se torna um objeto indexado por esses nomes em vez de um array. Em JSON para CSV escreve as chaves do objeto como primeira linha da saída.

O que acontece com uma entrada irregular ou mal formada?

Falhas graves (entrada vazia, JSON inválido, formas não suportadas) devolvem um resultado inválido claro. Problemas recuperáveis como linhas irregulares produzem uma conversão bem-sucedida com uma lista de avisos numerados por linha, para que possas ver o que foi ajustado sem perder o resto dos dados.

Posso obter saída JSON Lines (NDJSON)?

Sim. No modo CSV para JSON, ativa JSON Lines para emitir um objeto JSON por linha em vez de um único array JSON — útil para analisadores de fluxo e pipelines de estilo de registos.