CSV para JSON

Como usar CSV para JSON

CSV (Comma-Separated Values) é um dos formatos de dados mais antigos ainda em uso ativo — sua origem remonta aos anos 1960 e 1970, quando computadores precisavam de um jeito simples de trocar dados tabulares entre sistemas diferentes. A IBM usava variações desse formato em seus mainframes antes de qualquer padronização formal. Oficialmente padronizado pela RFC 4180 em 2005, o CSV sobreviveu à era dos bancos relacionais, ao XML, ao JSON, ao YAML — e segue firme. Todo sistema relevante exporta CSV: bancos de dados (MySQL, PostgreSQL, SQLite), planilhas (Excel, Google Sheets, LibreOffice), ferramentas de BI (Tableau, Power BI, Looker), sistemas de e-commerce, ERPs e CRMs. CSV é o esperanto dos dados tabulares.

A conversão de CSV para JSON é necessária quando você precisa usar dados tabulares num contexto que espera JSON: APIs REST, importadores de banco, ferramentas de transformação como `jq`, pipelines ETL, ou simplesmente quando você está desenvolvendo uma feature e quer fixtures de teste realistas baseadas em dados exportados de uma ferramenta real. A transformação é conceitualmente simples — a primeira linha do CSV vira as chaves do objeto JSON e cada linha seguinte vira um objeto — mas os detalhes práticos têm armadilhas: campos com vírgulas precisam de aspas, campos com aspas precisam de aspas escapadas, e quebras de linha dentro de campos são válidas no padrão mas problemáticas em parsers simples.

Um ponto de atenção importante é o separador. O nome diz 'comma' (vírgula), mas na prática há muita variação: países europeus que usam vírgula como separador decimal frequentemente usam ponto e vírgula como separador de campos no CSV — o Excel por padrão gera CSV com ponto e vírgula em configurações regionais europeias. Arquivos TSV (Tab-Separated Values) são comuns em bioinformática e ferramentas científicas. Esta ferramenta usa vírgula como separador padrão; se o seu CSV vier com ponto e vírgula ou tabulação, faça um buscar-e-substituir antes de converter, ou use a ferramenta de TSV para JSON para arquivos separados por tabulação.

Esta ferramenta processa o CSV inteiramente no navegador. A primeira linha é obrigatoriamente o cabeçalho — se o seu CSV não tiver cabeçalho, adicione uma linha com os nomes das colunas antes de converter. Campos entre aspas são tratados corretamente, incluindo vírgulas e quebras de linha dentro das aspas. O JSON gerado é um array de objetos, onde cada chave corresponde a um cabeçalho e os valores são sempre strings — se você precisar de números ou booleans, aplique uma etapa de coerção de tipos no código que consome o JSON.