2026-01-24 · 2 min de leitura
CSV ou JSON? Como escolher o formato certo para os seus dados
Tanto o CSV como o JSON armazenam dados tabulares, mas comportam-se de forma muito diferente. Saiba qual se adequa ao seu caso e como alternar livremente entre eles.
O CSV e o JSON são os dois formatos de texto simples mais comuns para mover dados, e ambos aparecem constantemente no trabalho diário. A escolha certa depende da finalidade dos dados, de quem os vai ler e do software envolvido.
A resposta curta
- CSV é uma tabela plana: linhas e colunas, sem hierarquia. O Excel, as bases de dados e a maioria das ferramentas de negócio falam-no nativamente.
- JSON é uma árvore: objetos e matrizes aninhados. As APIs, as aplicações web e os ficheiros de configuração usam-no quase exclusivamente.
Se os dados forem uma tabela simples e continuarem a ser, o CSV é normalmente a escolha pragmática. Se os dados tiverem estrutura, registos aninhados, objetos com campos mistos, ganha o JSON.
Quando o CSV é melhor
- Folhas de cálculo e bases de dados. Importar e exportar é uma operação de um clique no Excel, no Google Sheets, no PostgreSQL e em inúmeras outras ferramentas.
- Exportações legíveis por humanos. Um CSV abre num editor de texto e em qualquer aplicação de folhas de cálculo.
- Grandes tabelas planas. Os analisadores processam milhões de linhas com eficiência.
Quando o JSON é melhor
- APIs. Quase todas as APIs web devolvem e aceitam JSON.
- Dados aninhados. Encomendas com itens, objetos de configuração, payloads de eventos, estruturas que o CSV não consegue expressar sem as achatar.
- Clareza de tipos. O JSON distingue strings, números, booleanos e null; o CSV guarda tudo como texto.
Alternar entre eles é gratuito
Não precisa de escolher uma vez por todas. No Azpy pode converter um CSV em JSON em segundos, ou vice-versa, inteiramente no seu navegador. A primeira linha do seu CSV torna-se as chaves do objeto e cada linha seguinte um objeto JSON, e novamente, uma matriz de objetos JSON torna-se uma tabela.
- CSV para JSON, cole ou carregue, obtenha objetos JSON limpos.
- JSON para CSV, transforme uma matriz de objetos numa tabela pronta para a folha de cálculo.
- XLSX para CSV e XLSX para JSON, tire os dados do Excel primeiro.
Uma regra rápida
Faça-se uma pergunta: os dados são uma tabela plana ou uma estrutura? Tabela plana → CSV. Qualquer coisa com aninhamento → JSON. E na dúvida, converta: leva segundos e nada é enviado.
Ferramentas relacionadas
Artigos relacionados
Transforme um PDF digitalizado em texto pesquisável com OCR, no navegador e sem enviar o arquivo. Passos, dicas de precisão e o que revisar.
Transforme fotos JPG, PNG ou HEIC do iPhone num só PDF. Tamanho da página, orientação, qualidade e peso do ficheiro, dicas de digitalização e compressão.