Converter CSV, Excel, JSON e TSV sem perder a estrutura dos dados

Converter dados não é simplesmente mudar a extensão de um ficheiro. Cada formato possui capacidades próprias e certas informações não podem ser representadas da mesma forma em CSV, Excel, JSON ou TSV.

A pergunta certa é: que informações têm obrigatoriamente de sobreviver à conversão?

CSV para JSON: as linhas tornam-se objetos

Num CSV como:

id,nome,pais
1,Alice,Portugal
2,Bob,Belgica

uma representação JSON natural é:

[
  {"id":"1","nome":"Alice","pais":"Portugal"},
  {"id":"2","nome":"Bob","pais":"Belgica"}
]

Os cabeçalhos tornam-se chaves e cada linha torna-se um objeto.

JSON para CSV: é necessário criar colunas

A operação inversa é simples quando todos os objetos têm uma estrutura semelhante. Torna-se mais delicada com dados aninhados:

{"cliente":{"nome":"Alice","pais":"Portugal"}}

Um CSV não possui nativamente a noção de subobjeto. É necessário achatar a estrutura ou decidir que propriedades se tornarão colunas.

Uma conversão pode, portanto, ser tecnicamente correta e ainda exigir uma decisão de modelação.

Excel para CSV: a formatação não é preservada

Um livro Excel pode conter várias folhas, fórmulas, estilos, cores e tipos de célula. Um CSV representa apenas uma tabela textual.

Numa exportação, são os valores tabulares que interessam. Se a formatação ou as fórmulas forem indispensáveis, CSV provavelmente não é o formato final adequado.

CSV e TSV: o mesmo modelo, separador diferente

CSV e TSV representam linhas e colunas. A principal diferença é o separador.

Uma tabulação pode facilitar conjuntos de dados com muitas vírgulas, mas não elimina regras de quoting nem problemas com valores complexos. A escolha depende sobretudo do programa de destino.

Atenção aos números que são texto

Identificadores como 00042, códigos de produto ou determinados números não devem ser automaticamente convertidos em números quando os zeros iniciais são significativos.

Grandes identificadores numéricos também podem ultrapassar a precisão de alguns programas. Tratá-los como texto pode ser mais seguro.

Datas e definições regionais

03/04/2026 pode significar 3 de abril ou 4 de março conforme a convenção. Numa troca entre sistemas, um formato inequívoco como 2026-04-03 facilita a interpretação.

Codificação e caracteres especiais

Acentos, símbolos monetários e caracteres não latinos devem sobreviver à mudança de formato. UTF-8 é uma escolha comum para ficheiros de texto, embora alguns programas antigos ainda esperem outras codificações.

Depois da conversão, verifique valores que contenham acentos e caracteres especiais, não apenas linhas simples.

Converter depois de limpar

Se o ficheiro contém cabeçalhos incoerentes, duplicados ou espaços desnecessários, a conversão transportará esses defeitos para o novo formato.

Em muitos workflows, a sequência lógica é:

Importar
→ validar
→ limpar
→ harmonizar colunas
→ converter
→ verificar o resultado

A sequência não é obrigatória, mas evita usar a conversão como tentativa de reparação.

Aspas e quebras de linha num CSV

Uma célula CSV pode conter o próprio separador ou uma quebra de linha. Nesse caso, deve ser corretamente escapada, normalmente com aspas. Uma conversão ingénua que simplesmente divide cada linha por , pode destruir os dados.

JSON aninhado: o principal obstáculo para uma tabela

Um CSV não representa diretamente hierarquias. É necessário decidir como as achatar, por exemplo criando colunas como cliente.nome e cliente.endereco.cidade.

Para listas aninhadas, a decisão é ainda mais importante: duplicar linhas, serializar a lista numa célula ou manter JSON. Uma conversão bem-sucedida nem sempre significa uma conversão sem perda de estrutura.

Excel: fórmulas, folhas e apresentação

Ao converter um livro para CSV, é produzida uma tabela plana de cada vez. Cores, larguras de coluna e outros elementos visuais não têm equivalente. As fórmulas também exigem uma decisão: conservar a fórmula não faz sentido num CSV, enquanto conservar o valor calculado pode ser útil.

Antes de converter um livro complexo, identifique a folha e os dados realmente destinados à exportação.

Testar a reversibilidade quando é importante

Numa migração sensível, faça um teste de ida e volta sobre uma pequena amostra: converta para o formato de destino e confirme se seria possível reconstruir as informações essenciais.

Se não for, isso não é necessariamente um problema, mas a perda deve ser compreendida e aceite.

Escolher o formato para a utilização seguinte

Use CSV ou TSV para tabelas simples e portáteis, Excel quando as funcionalidades de folha de cálculo são importantes e JSON quando os dados serão consumidos por uma aplicação ou precisam de conservar uma estrutura mais rica.

A conversão correta é a que prepara adequadamente a etapa seguinte, não apenas a que produz um novo ficheiro.