CSV to 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.

CSV (Comma-Separated Values) is one of the oldest data formats still in active use — its origins trace back to the 1960s and 1970s, when computers needed a simple way to exchange tabular data between different systems. IBM used variations of this format on its mainframes before any formal standardization. Officially standardized by RFC 4180 in 2005, CSV has outlasted the era of relational databases, XML, JSON, and YAML — and it is still going strong. Every relevant system exports CSV: databases (MySQL, PostgreSQL, SQLite), spreadsheets (Excel, Google Sheets, LibreOffice), BI tools (Tableau, Power BI, Looker), e-commerce systems, ERPs, and CRMs. CSV is the Esperanto of tabular data.

Converting CSV to JSON is necessary when you need to use tabular data in a context that expects JSON: REST APIs, database importers, transformation tools like `jq`, ETL pipelines, or simply when you are building a feature and want realistic test fixtures based on data exported from a real tool. The transformation is conceptually simple — the first CSV row becomes the JSON object keys and each subsequent row becomes an object — but the practical details have traps: fields with commas need quoting, fields with quotes need escaped quotes, and line breaks inside fields are valid per the standard but problematic in simple parsers.

An important caveat is the separator. The name says 'comma', but in practice there is a lot of variation: European countries that use commas as the decimal separator often use semicolons as the CSV field separator — Excel by default generates semicolon-separated CSV under European regional settings. TSV (Tab-Separated Values) files are common in bioinformatics and scientific tools. This tool uses comma as the default separator; if your CSV uses semicolons or tabs, do a find-and-replace before converting, or use the TSV to JSON tool for tab-separated files.

This tool processes CSV entirely in the browser. The first line must be the header row — if your CSV has no header, add a line with column names before converting. Quoted fields are handled correctly, including commas and line breaks inside quotes. The generated JSON is an array of objects where each key corresponds to a header and values are always strings — if you need numbers or booleans, apply a type coercion step in the code that consumes the JSON.

CSV (Comma-Separated Values) es uno de los formatos de datos más antiguos que siguen en uso activo — sus orígenes se remontan a los años 60 y 70, cuando las computadoras necesitaban una forma sencilla de intercambiar datos tabulares entre sistemas diferentes. IBM usaba variaciones de este formato en sus mainframes antes de cualquier estandarización formal. Estandarizado oficialmente por la RFC 4180 en 2005, el CSV ha sobrevivido a la era de las bases relacionales, al XML, al JSON, al YAML — y sigue firme. Todos los sistemas relevantes exportan CSV: bases de datos (MySQL, PostgreSQL, SQLite), hojas de cálculo (Excel, Google Sheets, LibreOffice), herramientas de BI (Tableau, Power BI, Looker), sistemas de e-commerce, ERPs y CRMs. El CSV es el esperanto de los datos tabulares.

Convertir CSV a JSON es necesario cuando tienes que usar datos tabulares en un contexto que espera JSON: APIs REST, importadores de base de datos, herramientas de transformación como `jq`, pipelines ETL, o simplemente cuando estás desarrollando una funcionalidad y quieres fixtures de prueba realistas basadas en datos exportados de una herramienta real. La transformación es conceptualmente simple — la primera fila del CSV se convierte en las claves del objeto JSON y cada fila siguiente en un objeto — pero los detalles prácticos tienen trampas: los campos con comas necesitan comillas, los campos con comillas necesitan comillas escapadas, y los saltos de línea dentro de campos son válidos según el estándar pero problemáticos en parsers simples.

Un punto importante es el separador. El nombre dice 'comma' (coma), pero en la práctica hay mucha variación: los países europeos que usan la coma como separador decimal suelen usar el punto y coma como separador de campos en el CSV — Excel por defecto genera CSV con punto y coma en configuraciones regionales europeas. Los archivos TSV (Tab-Separated Values) son comunes en bioinformática y herramientas científicas. Esta herramienta usa la coma como separador predeterminado; si tu CSV usa punto y coma o tabulaciones, haz un buscar-y-reemplazar antes de convertir, o usa la herramienta de TSV a JSON para archivos separados por tabulación.

Esta herramienta procesa el CSV completamente en el navegador. La primera línea debe ser obligatoriamente la fila de cabecera — si tu CSV no tiene cabecera, añade una línea con los nombres de las columnas antes de convertir. Los campos entre comillas se manejan correctamente, incluyendo comas y saltos de línea dentro de las comillas. El JSON generado es un array de objetos donde cada clave corresponde a una cabecera y los valores son siempre strings — si necesitas números o booleanos, aplica un paso de coerción de tipos en el código que consume el JSON.