CSV ou JSON: qual formato usar para os seus dados
· 5 min de leitura
Os dois formatos guardam dados, mas resolvem problemas diferentes. CSV é tabela; JSON é estrutura. Escolher bem evita retrabalho na importação.
CSV: simples e universal
Cada linha é um registro, cada célula é um campo separado por vírgula, ponto e vírgula ou tabulação. Abre em qualquer planilha e é o formato preferido de importadores. Não guarda tipos: tudo é texto até alguém interpretar.
JSON: estrutura e hierarquia
Guarda listas, objetos aninhados e tipos explícitos (número, texto, booleano, nulo). É o formato padrão de APIs. Em compensação, é mais difícil de ler em planilha e ocupa mais espaço.
Critérios práticos
- Vai abrir no Excel ou importar em sistema legado? CSV.
- Vai consumir em código ou API? JSON.
- Precisa de dados aninhados? JSON — CSV exigiria achatar tudo.
- Precisa de arquivo pequeno e simples? CSV.
Cuidados na conversão
Ao converter JSON para CSV, listas internas viram texto JSON dentro da célula e chaves ausentes ficam vazias. Ao converter CSV para JSON, números viram números — e códigos com zero à esquerda perdem o zero, então revise campos como CEP e matrícula.
Separador importa
O Excel em português espera ponto e vírgula; o padrão internacional é vírgula. Se o arquivo abrir com tudo em uma coluna só, a conversão foi feita com o separador errado: gerar de novo com a opção correta resolve.