Por que sua exportação CSV adiciona um apóstrofo

Um apóstrofo inicial em um CSV exportado pode ser intencional. O CozyToolkit o adiciona a certos valores que parecem fórmulas quando a opção Proteger CSV de fórmulas de planilha está ativada. Essa opção vem ativada por padrão.

Por exemplo, o texto =1+1 vira '=1+1. Isso ajuda a evitar que a planilha interprete o valor como uma fórmula. Também altera os dados subjacentes, então uma conversão posterior de CSV para JSON manterá o apóstrofo.

Exporte quatro valores com aparência comum

Baixe o JSON de exemplo e faça upload no conversor CSV, JSON & YAML. Defina De como JSON e Para como CSV. Abra Opções e deixe Proteger CSV de fórmulas de planilha ativado.

O exemplo tem quatro valores rotulados. Na saída Código, os campos exportados são:

Use Baixar para salvar o CSV, ou inspecione a exportação verificada. O exemplo usa uma expressão aritmética inofensiva, um identificador e um deslocamento para facilitar a visualização da transformação.

A aba Tabela mostra uma prévia dos registros de entrada. Use Código ou o CSV baixado para ver os apóstrofos adicionados na exportação; a tabela de entrada não mostra essas strings escapadas.

Aspas no CSV têm função diferente

As aspas duplas externas fazem parte da sintaxe CSV. Um parser CSV as remove ao ler o campo. O apóstrofo dentro dessas aspas faz parte do valor do campo e permanece após a análise.

Escolha Usar resultado como entrada para converter o CSV exportado de volta para JSON. Com a detecção de números desligada, o primeiro valor agora é "'=1+1", não "=1+1". O JSON de ida e volta mostra os quatro resultados. Isso é uma alteração intencional dos dados, não uma falha nas aspas.

Se um sistema posterior precisar das strings originais exatamente, mantenha o JSON fonte. Não remova apóstrofos iniciais indiscriminadamente: alguns podem fazer parte dos dados originais.

Saiba o que essa opção verifica

O conversor usa a opção de escape de fórmulas do Papa Parse. Ela adiciona prefixo a valores que começam com =, +, -, @, uma tabulação ou um retorno de carro. Isso inclui valores benignos como identificadores e strings de números negativos; a opção não decide se cada valor é malicioso.

Essa é uma precaução limitada na exportação, não uma garantia de que qualquer planilha abrirá qualquer CSV com segurança. A verificação atual não cobre todos os prefixos possíveis, como uma quebra de linha inicial ou variantes em largura total desses símbolos. Configurações de importação de planilhas variam, e salvar e reabrir um CSV pode alterar seu escape. OWASP explica essas limitações de injeção CSV.

Para dados não confiáveis, importe via controles de importação de texto da planilha, trate explicitamente as colunas relevantes como texto e inspecione o resultado. Verifique o comportamento na aplicação e versão que receberá o arquivo.

Separe exportações de dados exatos das exportações para planilha

Quando um fluxo confiável máquina a máquina exige as strings originais exatas, desativar a proteção evita esses apóstrofos adicionados. Mantenha essa cópia separada dos arquivos que pessoas abrirão em planilhas. JSON costuma ser a forma mais clara de transferência quando não precisa de arquivo tabular.

Nosso registro de resultados compara proteção ligada e desligada usando o conversor real em 2 de novembro de 2026. Confirma o texto exportado e os valores lidos pelo parser. Não afirma que Excel, LibreOffice ou outra planilha foram testados, nem que o escape de fórmulas torna um arquivo não confiável universalmente seguro.