Como converter CSV para JSON: 3 métodos confiáveis (guia 2026)

O que realmente acontece ao converter CSV para JSON

CSV é plano: linhas de valores separadas por um delimitador, com a primeira linha geralmente trazendo os cabeçalhos das colunas. JSON é estruturado: objetos com chaves nomeadas, agrupados em um array. Converter mapeia cada linha de dados para um objeto, e cada cabeçalho para uma chave.

A parte sutil são os tipos de dados. Cada célula CSV é tecnicamente texto, mas JSON tem números, booleanos e nulos de verdade. Um bom conversor infere tipos: 30 vira número, true vira booleano, células vazias viram null. Manter IDs e CEPs como texto é deliberado — ninguém quer que 01310 vire 1310.

Método 1: conversor online gratuito (o mais rápido)

Para uma conversão pontual, uma ferramenta online é o caminho mais rápido — sem instalações nem código. Escolha uma que rode no seu navegador para que seus dados nunca saiam do seu dispositivo.

Cole seu CSV (ou arraste um arquivo .csv) no conversor.
Confirme o delimitador: vírgula para a maioria dos arquivos, ponto e vírgula se sua planilha usa.
Confira a prévia do JSON — os cabeçalhos viraram chaves, cada linha um objeto — e baixe o arquivo .json.

Método 2: script de Python (repetível)

Para desenvolvedores e tarefas recorrentes, um breve script de Python com pandas é a opção mais repetível. Ele lê a linha de cabeçalho automaticamente e escreve um array JSON bem indentado.

Python

import pandas as pd

# The header row becomes the keys automatically
df = pd.read_csv("data.csv")

# orient="records" -> one JSON object per row
# force_ascii=False keeps accents readable (no \uXXXX escapes)
df.to_json("data.json", orient="records", indent=2, force_ascii=False)

Execute com python convert.py. Se uma coluna precisa continuar como texto (IDs, CEPs com zeros à esquerda), leia-a explicitamente: pd.read_csv("data.csv", dtype={"zip": str}).

Método 3: Excel ou Google Sheets

Aqui vai a versão honesta: nem o Excel nem o Google Sheets conseguem salvar um arquivo como JSON nativamente. O caminho prático tem dois passos.

Limpe os dados na sua planilha e salve ou baixe como CSV (UTF-8).
Converta esse CSV para JSON com um conversor online ou o script de Python.
Dica: use o Power Query (Dados → Da Tabela) para corrigir cabeçalhos e remover linhas em branco antes de exportar o CSV.

Cabeçalhos, delimitadores e tipos de dados

Três coisas decidem se o resultado sai limpo ou inutilizável. Primeiro, a linha de cabeçalho: ela precisa existir e ser única — cabeçalhos duplicados ou ausentes geram chaves quebradas. Segundo, o delimitador: planilhas europeias costumam exportar ponto e vírgula porque a vírgula é o separador decimal por lá; se as linhas parecerem deslocadas, o delimitador está errado. Terceiro, as aspas: vírgulas ou aspas dentro de um campo precisam ir entre aspas duplas (RFC 4180) — qualquer CSV de verdade faz isso, e os conversores esperam por isso.

Datas são a armadilha clássica: 03/04/2026 significa 4 de março nos EUA e 3 de abril na maior parte da Europa. Quando as datas importam, normalize-as para o formato ISO (2026-04-03) antes de converter.

Problemas comuns e soluções rápidas

A maioria das dores de cabeça se resume a quatro problemas:

Acentos ilegíveis: o arquivo não está em UTF-8. Salve-o novamente com codificação UTF-8 (com BOM) antes de converter.
Tudo saiu como texto: a inferência de tipos está desligada ou os valores estavam entre aspas. Ative a opção de inferir tipos, ou aceite os textos — as APIs costumam lidar bem.
Linhas deslocadas: delimitador errado ou quebras de linha em campos sem aspas. Exporte o CSV corretamente de novo e tente outra vez.
Arquivos enormes travando o navegador: divida o CSV em partes menores ou use o método de Python acima.

O caminho inverso: de JSON para CSV

As APIs entregam JSON e as planilhas querem CSV — a viagem de volta é igualmente comum. Nosso guia complementar percorre os mesmos três métodos ao contrário.

Ler: Como converter JSON para CSV

Guias relacionados

Perguntas frequentes

É seguro converter CSV para JSON online?

Sim, se o conversor rodar inteiramente no seu navegador. Seu arquivo é processado localmente no seu dispositivo e nunca é enviado a um servidor. Evite ferramentas que exijam o upload de dados sensíveis para um servidor desconhecido.

O Excel consegue converter CSV para JSON diretamente?

Não — o Excel não tem exportação nativa para JSON. Salve ou baixe a planilha como CSV (UTF-8) e converta esse CSV com uma ferramenta online ou um breve script de Python. O mesmo vale para o Google Sheets.

Por que meus números viraram texto no JSON?

Porque cada célula CSV é texto até que algo decida o contrário. Conversores com inferência de tipos transformam 30 em número e true em booleano; valores entre aspas e colunas de ID continuam como texto de propósito, para que os CEPs mantenham os zeros à esquerda.

Dá para converter JSON de volta para CSV?

Sim. Veja nosso guia passo a passo «Como converter JSON para CSV» — os mesmos três métodos (conversor online, Excel, Python) funcionam na direção inversa.

Existe uma forma gratuita de converter CSV para JSON sem criar conta?

Sim: os conversores no navegador são gratuitos e sem conta. Cole seu CSV e baixe o array JSON. Para tarefas repetidas, o script curto de Python deste guia roda offline, sem limites.

Como impedir o Excel de remover zeros à esquerda ao converter para JSON?

Marque as colunas de ID e CEP como Texto antes de salvar o CSV: no Excel use Dados → De Texto/CSV e fixe o tipo da coluna em Texto, ou leia o arquivo com dtype={"zip": str} em Python. Depois que os zeros somem do CSV, nenhum conversor consegue recuperá-los.

Posso converter para JSON um CSV que usa ponto e vírgula?

Sim: basta dizer ao conversor que o delimitador é ponto e vírgula em vez de vírgula; as planilhas europeias exportam assim por padrão. O método Python resolve com pd.read_csv("data.csv", sep=";").