Converter CSV para JSON

Ela reconhece vírgulas entre aspas, aspas escapadas, quebras de linha do Windows ou Unix e quebras dentro de valores citados. Toda linha de dados deve ter exatamente a mesma quantidade de colunas do cabeçalho; caso contrário, a conversão para com um erro preciso.

Prepare o texto CSV com um cabeçalho confiável

Comece com uma linha de cabeçalho que dê a cada coluna um nome único e não vazio. Os valores continuam sendo strings porque o CSV não possui um sistema de tipos confiável: algo que parece número pode ser um código de conta com zeros iniciais importantes, enquanto uma data pode ser ambígua entre regiões. Preservar o texto evita suposições destrutivas e permite que o aplicativo de destino aplique seu próprio esquema.

O conversor aceita terminações de linha Unix e Windows e remove uma marca de ordem de bytes inicial que alguns programas de planilha acrescentam. O uso padrão de aspas em CSV também é aceito. Coloque um valor entre aspas duplas quando houver vírgula ou quebra de linha e duplique uma aspa literal.

Os espaços são preservados.

Entenda a validação rigorosa da quantidade de colunas

A conversão é propositalmente rigorosa quanto à estrutura. Depois de analisar o cabeçalho, ela conta as colunas e exige que todos os registros seguintes tenham a mesma quantidade. Um valor final ausente ainda precisa aparecer como campo vazio, incluindo a vírgula que o inicia.

Da mesma forma, uma vírgula inesperada cria outra coluna, exceto quando está dentro de um campo corretamente citado. Quando um registro não corresponde, a operação informa o número da linha CSV a partir de um, a quantidade encontrada e a esperada. Isso impede um problema comum e perigoso em conversores permissivos: valores deslocados para títulos errados ou campos ausentes descartados sem aviso.

Valores vazios são permitidos e viram strings vazias; registros inconsistentes não são aceitos. O analisador também rejeita valor entre aspas não terminado, aspa no meio de campo não citado e caracteres após a aspa de fechamento. Assim, exportações defeituosas aparecem na entrada, antes que propriedades incorretas sejam armazenadas ou transformadas.

Como usar os registros convertidos com segurança

Como o algoritmo é determinístico, o mesmo texto CSV sempre produz a mesma saída, sem solicitação de rede, valor aleatório ou horário. Considere o resultado uma conversão estrutural fiel, e não uma etapa de limpeza. A ferramenta não deduz números, booleanos, datas ou valores nulos, nem renomeia títulos ou conserta linhas quebradas.

Essa separação é útil: a conversão determina qual valor pertence a cada cabeçalho, e um validador posterior decide seu significado. Se a origem usar outro delimitador, normalize-a para vírgulas antes da conversão.