CSV to
JSON
Convert CSV data to JSON instantly. Supports custom delimiters, quoted fields, and header rows.
How It Works
Add CSV
Upload a CSV file or paste your CSV data directly.
Configure
Choose your delimiter and header row settings.
Get JSON
Copy or download the converted JSON instantly.
Converta CSV para JSON online com suporte para delimitadores personalizados, campos entre aspas e cabeçalhos configuráveis. O conversor CSV para JSON da ConverterUp foi pensado para analistas a importar folhas de cálculo para APIs, programadores a alimentar bases de dados e gestores de produto a transformar exportações do Notion ou do Google Sheets em dados estruturados. Cole um CSV ou carregue um ficheiro, escolha as opções de delimitador e cabeçalho e descarregue o array JSON resultante ou copie-o para a área de transferência. A interpretação corre no browser com um parser RFC 4180 em streaming, por isso listas de clientes e exportações confidenciais nunca chegam a servidores de terceiros.
Idiossincrasias do CSV: RFC 4180, aspas, BOM, codificação
O RFC 4180 é o mais próximo que existe de uma especificação para CSV, mas a maioria dos ficheiros CSV na prática desvia-se dela. As regras canónicas: separador vírgula, fim de linha CRLF, aspas duplas à volta de campos com vírgulas ou quebras de linha, e uma aspa dupla literal dentro de um campo entre aspas é escapada com duas aspas duplas ("").
O BOM (byte order mark, EF BB BF para UTF-8) é adicionado pelo Excel ao gravar CSV em UTF-8 e parte parsers ingénuos rotineiramente — o nome da primeira coluna passa a \uFEFFid em vez de id. A ConverterUp deteta e remove o BOM automaticamente. Se está a depurar um parser a jusante, verifique se a chave da primeira coluna tem um prefixo BOM escondido.
Codificação: o Excel em Windows assume muitas vezes Windows-1252 ou UTF-16 LE, e não UTF-8. Gravar um CSV com acentos no Excel e importá-lo numa API que só aceita UTF-8 é a origem clássica do mojibake João. Converta para UTF-8 com BOM no Excel via Guardar Como → CSV UTF-8, ou abra o ficheiro num editor de texto a sério para confirmar a codificação antes de interpretar.
Fim de linha varia: ferramentas Windows produzem \r\n, Unix \n, macOS antigo \r. O RFC 4180 manda CRLF mas qualquer parser robusto aceita os três. A ConverterUp aceita — mas se está a escrever o seu próprio parser, não assuma um único fim de linha.
ToolSeo.csv-to-json.section1.p5
Deteção de cabeçalhos e saída JSON aninhada
Com cabeçalhos ativos, a primeira linha torna-se nomes de propriedade e cada linha seguinte é emitida como objeto: [{"id":"1","name":"Ana"},…]. É o formato padrão que a maioria das APIs espera. Com cabeçalhos desativados, cada linha é emitida como array ([["1","Ana"],…]) — útil para dados posicionais ou quando o CSV não tem linha de cabeçalho.
Os nomes das colunas são usados tal e qual, incluindo espaços e caracteres especiais. Se precisa de chaves em camelCase ou snake_case, passe os cabeçalhos pelo conversor de capitalização antes ou ative a opção Normalizar cabeçalhos, que apara espaços, passa a minúsculas e substitui espaços por sublinhados.
Os dados CSV reais são planos por natureza; os consumidores JSON querem muitas vezes objetos aninhados. A ConverterUp suporta uma notação por caminho com pontos nos cabeçalhos: uma coluna chamada address.city cria uma estrutura aninhada { "address": { "city": "…" } } na saída. Use a notação items[0].sku para arrays aninhados.
A inferência de tipos é opt-in. Por defeito, todos os valores são strings, o que preserva zeros à esquerda (códigos postais, números de telefone, SKUs) e evita a armadilha 0.1 + 0.2 dos floats em JavaScript. Ative a inferência para detetar números, booleanos, datas ISO e marcadores null automaticamente — útil ao alimentar uma base de dados com colunas tipadas.
ToolSeo.csv-to-json.section2.p5
Problemas comuns de conversão
Vírgulas dentro de valores: "Smith, John" tem de ser envolvido em aspas duplas. Se o CSV de origem tem vírgulas não citadas dentro dos valores (um bug frequente em ficheiros editados à mão e em algumas exportações legadas), cada linha vai ter contagem de colunas errada. O modo de deteção automática da ConverterUp sinaliza linhas com contagens inconsistentes e propõe ponto e vírgula como delimitador provável.
Quebras de linha dentro de células: valores multi-linha (por exemplo, moradas, comentários) são CSV válido quando envolvidos em aspas duplas — o parser sabe que um \n dentro de "…" é parte do valor, não um separador de registo. Colar CSV em muitos editores de texto destrói esta distinção; carregue o ficheiro em vez de copiar-e-colar por um UI que possa normalizar fins de linha.
Aspas não escapadas: um valor que contém uma " literal tem de duplicá-la ("He said ""hi"""). Alguns exportadores usam escape com barra invertida ("He said \"hi\""), o que é RFC 4180 inválido mas comum em ferramentas que não são CSV-nativas. Ative Tratamento permissivo de aspas se a sua origem usa escapes com barra invertida.
ToolSeo.csv-to-json.section3.p4
ToolSeo.csv-to-json.section3.p5
ToolSeo.csv-to-json.section4.heading
ToolSeo.csv-to-json.section4.p1
ToolSeo.csv-to-json.section4.p2
ToolSeo.csv-to-json.section4.p3
ToolSeo.csv-to-json.section4.p4
ToolSeo.csv-to-json.section4.p5
ToolSeo.csv-to-json.section5.heading
ToolSeo.csv-to-json.section5.p1
ToolSeo.csv-to-json.section5.p2
ToolSeo.csv-to-json.section5.p3
ToolSeo.csv-to-json.section5.p4
ToolSeo.csv-to-json.section5.p5
Perguntas frequentes
Que delimitadores são suportados?
Vírgula, ponto e vírgula, tabulação, barra vertical e um campo personalizado onde pode escrever qualquer caractere. A deteção automática inspeciona as primeiras linhas e escolhe o delimitador que produz a contagem de colunas mais consistente.
Como são tratados os campos entre aspas e aspas escapadas?
A ConverterUp segue o RFC 4180: campos entre aspas duplas podem conter vírgulas e novas linhas, e uma aspa dupla literal dentro de um campo entre aspas escapa-se com duas aspas duplas. Excel e Google Sheets seguem as mesmas regras.
Qual o tamanho máximo de CSV?
Até 50 MB por ficheiro. O parser em streaming mantém o uso de memória baixo, por isso até ficheiros com centenas de milhares de linhas convertem sem rebentar com o separador do browser.
Posso obter um array de objetos em vez de arrays?
Sim. Ative a opção de cabeçalho e a primeira linha é usada como chaves JSON, produzindo um array de objetos. Desative-a para obter um array de arrays, útil quando a origem não tem cabeçalho ou quando quer acesso por posição.
Como são representados campos vazios e valores em falta?
Um campo vazio passa a string vazia (<code>""</code>) por defeito. Ative <em>Vazio como null</em> para mapear <code>,,</code> para <code>null</code> JSON — preferível ao alimentar uma base de dados que distingue string vazia de NULL. Uma linha com menos colunas que o cabeçalho fica com as chaves finais em falta a <code>""</code> ou <code>null</code>, consoante o mesmo interruptor.
Porque é que o Excel parte o meu CSV quando volto a guardar?
O Excel re-codifica para a codificação por defeito do sistema (Windows-1252 em muitas localizações Windows), remove o BOM UTF-8 e reformata números e datas de forma agressiva — um zero à esquerda num código postal <code>00501</code> vira <code>501</code>, uma data ISO vira uma data no formato americano. Para passar um CSV pelo Excel em segurança, importe via <em>Dados → De Texto</em> e marque cada coluna explicitamente como <em>Texto</em>.
ToolSeo.csv-to-json.q7
ToolSeo.csv-to-json.a7
ToolSeo.csv-to-json.q8
ToolSeo.csv-to-json.a8