Converter JSON para CSV para visualização no Excel: Guia de Requisitos de Estrutura e Problemas Comuns
Este artigo explica regras estruturais, processamento de codificação e outros detalhes para converter JSON em CSV compatível com Excel, e resolve 5 tipos comuns de erros de abertura
Atualizado 2026-08-11
Requisitos de estrutura JSON para conversão em tabela
Apenas JSON no formato de matriz de objetos pode ser achatado em uma tabela CSV. Neste tipo de JSON, o nível superior é uma matriz, cada elemento da matriz é um objeto com estrutura semelhante, a chave de cada objeto pode ser usada para gerar uma coluna de tabela correspondente, e o valor é usado para gerar o conteúdo da célula correspondente.
JSON que não está no formato de matriz de objetos não pode ser convertido diretamente em uma tabela bidimensional. Por exemplo, JSON com um único objeto no nível superior e JSON com uma matriz de valores puros no nível superior não estão em conformidade com a lógica estrutural de uma tabela bidimensional, e não podem gerar uma tabela padrão.
- Exemplo de estrutura válida: [{"name":"张三","age":25},{"name":"李四","age":30}]
- Exemplo de estrutura inválida: {"data":[{"name":"张三"},{"name":"李四"}]}
Limite de achatamento para campos aninhados
Quando uma matriz de objetos JSON contém objetos ou matrizes aninhadas, a maioria das ferramentas de conversão expande objetos aninhados usando nomes de chave separados por ponto. Por exemplo, o campo city sob um objeto address gerará um nome de coluna como "address.city".
Geralmente existe um limite para o processamento de matrizes aninhadas: apenas o primeiro nível de aninhamento pode reter os valores originais concatenados por vírgula e armazená-los na célula correspondente. Para matrizes aninhadas com profundidade maior que um nível, a string de formato JSON original é armazenada na célula para evitar danificar a estrutura bidimensional da tabela.
Codificação CSV e processamento de texto chinês ilegível
Quando o Excel 2016 e versões anteriores do Windows abrem diretamente um arquivo CSV codificado em UTF-8, eles analisam o conteúdo com codificação GBK por padrão. Os caracteres chineses aparecerão ilegíveis devido à incompatibilidade de codificação.
Adicionar uma marca UTF-8 BOM de 3 bytes no cabeçalho de um arquivo codificado em UTF-8 permite que o Excel em sistemas Windows reconheça automaticamente a codificação UTF-8, para que os caracteres chineses possam ser analisados corretamente e o problema do texto ilegível seja eliminado.
Seleção de delimitador e configurações regionais do Excel
O delimitador padrão de um arquivo CSV deve corresponder às configurações regionais do Excel para ser exibido corretamente em colunas separadas. O separador de lista padrão para sistemas Windows em chinês é uma vírgula, e na maioria dos casos selecionar vírgula como delimitador permite a separação normal de colunas.
O delimitador padrão para sistemas em algumas regiões europeias é um ponto e vírgula. Se todo o conteúdo for compactado em uma coluna após abrir o CSV, você pode alternar para o delimitador correspondente e gerar novamente o arquivo CSV.
| Configuração regional do sistema | Delimitador recomendado |
|---|---|
| Chinês (China Continental) | Vírgula |
| Algumas regiões europeias | Ponto e vírgula |
| Cenário de importação de texto simples para o Excel | Tabulação |
Evitar notação científica para números longos
O Excel habilita a notação científica por padrão para números com mais de 11 dígitos, e preenche automaticamente zeros à direita para números com mais de 15 dígitos, portanto a cadeia de números original não pode ser retida. Isso tem um grande impacto em dados como números de identificação e números de pedido.
Ao converter para CSV, adicionar aspas duplas de meia largura ao redor de campos de números longos e adicionar uma aspa simples de meia largura no início pode forçar o Excel a reconhecer o conteúdo como formato de texto, e reter o conteúdo completo do número longo original.
Perguntas frequentes
Como converter JSON que não é matriz de objetos para Excel?
Extraia a matriz de objetos interna primeiro antes da conversão. A maioria das ferramentas suporta a especificação de um caminho JSON para extrair a matriz alvo. Consulte a documentação da sua ferramenta de conversão para obter regras de extração específicas.
Adicionar UTF-8 BOM afeta a leitura do CSV por outro software?
A maioria das linguagens de programação modernas e editores de texto são compatíveis com arquivos UTF-8 com BOM. Apenas algumas ferramentas em ambientes Linux podem detectar caracteres extras no cabeçalho do arquivo, portanto você precisa escolher de acordo com o seu cenário de uso.
O conversor de JSON para CSV do OKfmt é gratuito?
Esta ferramenta de conversão online fornece uma cota de conversão gratuita. Para a cota específica e regras de pagamento, consulte as informações públicas atuais no site oficial.