SS Toolbox
SS Toolbox
Todos os dados são processados localmente

Conversor CSV para JSON para Excel, cabeçalhos e campos aninhados

Converta no navegador exportações CSV do Excel em arrays JSON e volte a escrever JSON como CSV. A primeira linha vira chaves dos objetos, objetos aninhados são achatados em colunas com pontos e arrays ficam como texto JSON em uma única célula.

Como este conversor CSV ↔ JSON se comporta

  1. A primeira linha é sempre o cabeçalho

    CSV → JSON usa a linha 1 como nomes de campos e gera um objeto por linha restante. Um arquivo sem cabeçalho perde a primeira linha de dados; um arquivo só com cabeçalho retorna um array vazio.

  2. JSON aninhado vira colunas com pontos

    JSON → CSV grava meta.x / meta.y para objetos aninhados, e a conversão inversa reconstrói o objeto. Estruturas simples fazem ida e volta limpa.

  3. Arrays ficam dentro de uma célula

    Listas e arrays de objetos são serializados como strings tipo [1,2,3], mantendo a tabela retangular. CSV → JSON interpreta uma célula parecida com JSON de volta para array ou objeto.

  4. Números são adivinhados, não preservados

    Células numéricas viram números (1.50 → 1.5, 1e5 → 100000). Zeros à esquerda como 007 permanecem texto, IDs acima de 2^53 perdem precisão e +4 não é tratado como número.

  5. Roda na página, arquivos ficam locais

    Escolha um arquivo .csv ou .json ou cole o texto; baixe o resultado. Nada é enviado, mas a conversão é síncrona e um arquivo muito grande pode travar a aba.

Perguntas frequentes sobre CSV ↔ JSON

O CSV precisa de linha de cabeçalho?

Sim. A primeira linha não vazia é o cabeçalho e cada linha seguinte vira um objeto JSON. Sem cabeçalho, a primeira linha de dados é consumida como nomes de colunas. Um arquivo só com cabeçalho retorna um array vazio.

Como mantenho telefones, CEPs ou IDs de pedido como texto?

Zeros à esquerda como 007 permanecem texto automaticamente, mas 1.0 vira 1, 1e5 vira 100000 e inteiros acima de 2^53 perdem dígitos. Não há opção de «ler tudo como texto»: coloque esses valores entre aspas ou pré-formate-os no arquivo de origem.

Como objetos aninhados e arrays são representados?

JSON → CSV achata objetos em cabeçalhos com pontos (user.name) e guarda arrays como texto JSON em uma célula. CSV → JSON divide esses cabeçalhos de volta em objetos e interpreta células parecidas com JSON. Uma chave que realmente contém ponto é escrita como a\.b para não ser dividida.

O que acontece com valores vazios, aspas, quebras de linha e delimitadores?

Células vazias viram strings vazias. Vírgulas, aspas e quebras de linha são colocadas entre aspas na exportação e lidas corretamente de volta. Uma linha vazia gera um objeto parcial apenas com a primeira coluna, e células além do cabeçalho são descartadas ou deslocadas. Só vírgula é aceita; arquivos com ponto e vírgula ou tabulações são lidos como uma única coluna.

Meu CSV do Excel tem \r\n e BOM — por que quebra?

O parser divide apenas por LF: com CRLF o último nome de cabeçalho pode manter um \r, e um campo entre aspas com CRLF pode engolir o restante do arquivo. Um BOM UTF-8 também gruda na primeira chave. Salve novamente como UTF-8 sem BOM e com LF antes de converter.

Posso escolher outro delimitador?

Não. Não há opção de delimitador, aspas ou codificação; apenas texto separado por vírgulas é interpretado. Arquivos com ponto e vírgula ou tabulação são lidos como uma coluna cuja chave é a linha inteira. Converta antes para CSV com vírgulas se precisar.

CSV → JSON → CSV é uma ida e volta sem perdas?

Não é garantido. A ordem dos campos é mantida, mas a inferência de tipos, o achatamento com pontos, arrays codificados em JSON e a saída literal de chaves ausentes podem alterar os dados: null é gravado como null e uma chave ausente como o texto undefined. Valores com aparência de data continuam strings simples — o editor JSON não consegue criar objetos Date, então não há formatação de data. Uniformize os objetos antes de exportar.

Ferramentas Relacionadas
SponsorMindElixir