Células CSV com vírgulas, aspas e quebras de linha

Uma célula CSV pode conter uma vírgula, uma aspa ou uma quebra de linha. Isso não significa que o arquivo está corrompido. Significa que a célula precisa ficar entre aspas, e contar linhas de texto não indica necessariamente quantos registros ela contém.

Baixe o CSV de exemplo. Abra o conversor CSV, JSON & YAML e faça o upload. O arquivo tem dois registros, mesmo que uma legenda ocupe duas linhas:

name,caption
"Lee, Sam","First line
Second line"
Mina,"She said ""hello""."

Leia as aspas antes de dividir uma linha

A vírgula em "Lee, Sam" faz parte do nome. A quebra de linha entre First line e Second line faz parte da legenda. Nenhuma delas inicia um novo campo ou registro porque está dentro das aspas duplas que envolvem o texto.

Dentro de uma célula entre aspas, duas aspas duplas consecutivas representam um único caractere de aspas duplas. Então "She said ""hello""." vira o texto She said "hello".. As aspas externas e as aspas internas duplicadas são sintaxe CSV, não caracteres extras para manter no valor. Essas regras estão descritas nas notas do formato CSV do RFC 4180.

Dividir o texto bruto em cada vírgula ou quebra de linha ignora essa distinção. Remover todas as aspas também não resolve: transforma vírgulas dentro de nomes em separadores de coluna.

Converta o exemplo e verifique os valores

1. Faça upload do exemplo ou cole o CSV acima no editor de entrada.
2. Defina De como CSV e Para como JSON.
3. Em Opções, mantenha A primeira linha contém cabeçalhos ativado e Detectar números e booleanos no CSV desativado. Defina Delimitador de CSV para Vírgula se a detecção automática estiver errada.
4. Confira o resultado em Código. Deve conter dois objetos, cada um com nome e legenda. Tabela mostra rapidamente as duas linhas e colunas.

O arquivo de exemplo usa quebras de linha CRLF, incluindo a quebra dentro da primeira legenda. A saída JSON contém:

[
  {
    "name": "Lee, Sam",
    "caption": "First line\r\nSecond line"
  },
  {
    "name": "Mina",
    "caption": "She said \"hello\"."
  }
]

O JSON mostra retorno de carro e nova linha como sequências de escape. Ainda representam uma quebra de linha na string. Se você colar o exemplo desta página em vez de enviar o arquivo, sua área de transferência pode fornecer apenas LF; ver \n em vez de \r\n é esperado. Baixe a saída JSON verificada para a versão CRLF.

Teste o caminho de volta

Escolha Usar resultado como entrada para converter o JSON de volta para CSV. Mantenha todas as colunas selecionadas. O CSV exportado coloca aspas novamente na vírgula, legenda multilinha e aspas. Converter de volta para JSON preservou os dois registros e todos os valores no nosso teste.

Isso é uma comparação de dados, não uma garantia de que todo arquivo CSV volte exatamente igual byte a byte. Aspas, quebras finais e delimitadores podem ser escritos de forma diferente. A ferramenta também protege valores que parecem fórmulas de planilha por padrão, adicionando um apóstrofo inicial. Nosso exemplo não tem esses valores; mantenha essa proteção ao abrir exportações não confiáveis em planilhas.

Quando a vírgula realmente é um erro

O exemplo quebrado deixa a vírgula no nome sem aspas. Ele tem um cabeçalho de duas colunas e uma linha com três campos, então o conversor rejeita a incompatibilidade. Coloque aspas no nome inteiro como "Lee, Sam" para corrigir; não apague parte do nome.

O registro de resultados contém os valores esperados, teste de ida e volta e resultado de entrada rejeitada de 26 de outubro de 2026. Ele testa esse pequeno exemplo com o parser do conversor, não as regras de importação CSV de todas as planilhas.