CSV para XML: como converter um arquivo CSV em XML válido online
Converta CSV em XML grátis online: use o cabeçalho como nomes de elemento, defina raiz e linha, corrija nomes inválidos, escape valores e escolha a codificação certa.
Atualizado em 8 de novembro de 20269 min de leitura
Para converter CSV em XML, abra o conversor de CSV para XML, solte o seu arquivo, dê nome ao elemento raiz e ao elemento de linha, confira a prévia e baixe o resultado. Cada linha do CSV vira um elemento de linha, e cada coluna vira um elemento filho com o nome do cabeçalho ou, se preferir, um atributo. O que exige atenção não é a conversão em si, mas a diferença entre os dois formatos: o cabeçalho de uma planilha pode ser qualquer texto, enquanto um nome XML segue regras rígidas, e caracteres como & e < precisam ser escapados. Este guia explica como funciona o mapeamento, o que cada configuração faz e o que, na prática, faz uma importação falhar.
Como um conversor de CSV para XML mapeia suas colunas
Pegue um arquivo de três colunas com o cabeçalho id,city,total e uma linha de dados 7,Paris,19.90. Com as configurações padrão, o resultado é um elemento raiz chamado root, um elemento chamado row para cada linha de dados e um elemento filho por coluna: <root><row><id>7</id><city>Paris</city><total>19.90</total></row></root>. A primeira linha do CSV nunca é gravada como dado; ela fornece os nomes.
| Parte do CSV | Vira em XML | Configuração que controla |
|---|---|---|
| O arquivo inteiro | Um elemento raiz que envolve tudo | Elemento raiz (padrão root) |
| Cada linha de dados | Um elemento dentro da raiz | Elemento de linha (padrão row) |
| Cada campo do cabeçalho | O nome de um elemento filho ou de um atributo | Primeira linha como nomes de elemento |
| Cada célula | Texto de elemento, valor de atributo ou CDATA | Escrever colunas como, mais ajustes por coluna |
| Uma célula vazia | Um elemento vazio, nada ou xsi:nil | Células vazias |
| Sem linha de cabeçalho | Os nomes column_1, column_2 e assim por diante | Desligue Primeira linha como nomes de elemento |
Antes de escolher qualquer coisa, pergunte qual programa vai ler o arquivo. Se outro sistema espera um formato específico (por exemplo <products><product> com um atributo sku), use exatamente esses nomes. XML diferencia maiúsculas de minúsculas: Product e product são elementos diferentes, e um importador que procura um não vai encontrar o outro.
Converter CSV para XML, passo a passo
Adicione o CSV
Abra a ferramenta de CSV para XML e solte um arquivo .csv, .tsv, .txt ou .psv. O delimitador (vírgula, ponto e vírgula, tabulação ou barra vertical), o caractere de aspas e a codificação são detectados a partir do próprio arquivo.
Dê nome à raiz e à linha
Troque root e row pelos nomes que o sistema de destino espera, por exemplo orders e order. Se você digitar um nome que o XML não aceita, a ferramenta avisa e corrige o nome antes de usá-lo.
Escolha como as colunas são escritas
Em Escrever colunas como, escolha Elementos ou Atributos para o arquivo todo. Depois, na tabela Colunas, você pode mudar qualquer coluna para CDATA ou Ignorar, e vê cada cabeçalho ao lado do nome de elemento que será usado.
Decida sobre células vazias e a declaração
Escolha Elemento vazio, Omitir ou xsi:nil para as células em branco e deixe Incluir declaração XML ligado, a menos que o destinatário peça um fragmento sem ela.
Confira a prévia e baixe
A prévia mostra as primeiras vinte linhas geradas pelo mesmo código da exportação, com a indicação Bem formado ou Mal formado. Quando estiver certo, clique em Baixar XML.
Cabeçalhos que o XML não aceita
É aqui que a maioria das conversões feitas à mão falha. Um nome de elemento XML precisa começar com uma letra ou um sublinhado e não pode conter espaços, a maior parte dos sinais de pontuação nem dois-pontos. Nomes que começam com xml, em qualquer combinação de maiúsculas e minúsculas, são reservados pela especificação. Cabeçalhos de planilha quebram essas regras o tempo todo: Order ID, 2024, -id, Total (£), Unit price/kg. Um conversor que copia esses textos direto para as tags gera um arquivo que qualquer analisador rejeita já na primeira linha.
| Cabeçalho no CSV | Nome de elemento usado | Por quê |
|---|---|---|
| First Name | First_Name | Uma sequência de caracteres inválidos vira um único sublinhado |
| Total (£) | Total | A pontuação no final é removida, em vez de virar sublinhados |
| 2024 | _2024 | Um nome não pode começar com dígito, então um sublinhado é adicionado |
| xml ou XmlData | Recebe um sublinhado na frente | Nomes que começam com xml são reservados |
| Name, Name | Name, Name_2 | Nomes repetidos são numerados para se distinguirem |
| Führung, 名前 | Sem alteração | Letras de qualquer sistema de escrita são válidas em XML |
A ferramenta corrige cada nome segundo as regras de nomes do XML e mostra o cabeçalho original ao lado do nome usado, com a contagem de quantos foram renomeados, então nada muda sem você ver. Se o sistema de destino precisa de nomes específicos, o mais limpo é renomear os cabeçalhos no próprio CSV antes de converter: assim o arquivo que você guarda e o XML que você envia ficam iguais.
Nomes de raiz e linha, elementos ou atributos por coluna, CDATA, regras para células vazias, indentação e codificações são todos grátis. Grátis: um arquivo de até 25 MB. Pro: até 50 arquivos de uma vez em um ZIP, aninhamento por uma coluna, namespaces e um esquema XSD gerado. Tudo roda no seu dispositivo, não nos nossos servidores.
Converter CSV para XMLElementos, atributos ou CDATA?
Elementos são a escolha segura padrão. <city>Paris</city> aceita texto de qualquer tamanho, inclusive quebras de linha, pode ficar vazio e pode ter um tipo. Escolha elementos quando estiver em dúvida.
Atributos colocam o valor na própria linha: <row id="7" city="Paris"/>. O arquivo fica bem menor e é fácil de ler com valores curtos, como IDs e códigos. Muitos importadores esperam IDs como atributos e campos descritivos como elementos; por isso o padrão pode ser alterado por coluna. Tem uma armadilha: analisadores XML trocam uma tabulação ou quebra de linha literal dentro de um atributo por um espaço, então um endereço de várias linhas gravado como atributo simples perde as quebras de linha. Este conversor grava esses caracteres como referências ( para uma quebra de linha), e o valor volta intacto.
CDATA envolve um valor para que ele passe sem alteração, o que serve para uma coluna com um trecho de HTML. Ignorar deixa uma coluna totalmente de fora, útil para chaves internas que não devem ir para o outro sistema.
Escape: os caracteres que quebram o XML
Cinco caracteres têm significado especial em XML. No texto de um elemento, & vira &, < vira < e > vira >. Dentro de um atributo, aspas duplas e simples também são escapadas, como " e '. Um nome de produto como Fish & Chips <large> precisa chegar como Fish & Chips <large>, senão o arquivo não fica bem formado. O conversor faz isso em todos os valores, então não escape nada antes no CSV: se fizer, & vira &amp; e o destinatário mostra o código em vez do caractere.
Alguns caracteres não podem aparecer em XML 1.0 de jeito nenhum, escapados ou não: a maioria dos caracteres de controle abaixo do espaço, como o byte NUL ou a quebra de página que exportações de bancos de dados antigos às vezes trazem. Eles são removidos, e a ferramenta informa quantos eram. Se esse número for alto, a exportação de origem provavelmente está danificada ou em outra codificação.
Um CSV com aspas quebradas (uma aspa solta no meio de um campo) pode juntar várias linhas em uma única célula comprida, e nenhum escape de XML resolve isso. Passe o arquivo antes pelo CSV Escape / Fix ou abra-o no visualizador de CSV para ver se as colunas estão alinhadas.
Codificações e acentos que viram caracteres estranhos
O arquivo XML é sempre gravado em UTF-8, e a linha de declaração diz isso: <?xml version="1.0" encoding="UTF-8"?>. O risco está na entrada. Se o CSV for lido com a codificação errada, café vira café ou um ponto de interrogação, e esse estrago passa para o XML como se fosse texto de verdade.
| O CSV veio de… | Codificação a usar | Sinal de que a escolha está errada |
|---|---|---|
| A maioria dos aplicativos modernos e exportações online | UTF-8 (Detectar encontra) | é ou ’ no lugar de acentos e apóstrofos |
| Uma exportação como texto Unicode de uma planilha | UTF-16 LE (normalmente uma marca de ordem de bytes decide) | Uma única coluna cheia de lacunas |
| Um sistema antigo da Europa Ocidental ou um salvamento padrão de planilha | Windows-1252 | Símbolos de euro e aspas curvas viram quadradinhos |
| Um arquivo que realmente é Latin-1 | ISO-8859-1 (real) | Raro; os bytes 0x80 a 0x9F são códigos de controle, não aspas |
Deixe Codificação em Detectar primeiro. Se o arquivo começa com uma marca de ordem de bytes (BOM), ela sempre prevalece sobre a lista, e a ferramenta avisa que ignorou a sua escolha. Antes de baixar, confira na prévia uma linha com nomes acentuados ou com ç.
Configurações que mudam o que o destinatário vê
- Células vazias: Elemento vazio grava <city></city>, Omitir não grava nada e xsi:nil grava <city xsi:nil="true"/>, a única opção que informa a um sistema com esquema que o valor está ausente de propósito.
- Adicionar xsi:type aos elementos: marca cada valor como integer, decimal, boolean, date, time, dateTime ou string, mas só quando todos os valores da coluna se encaixam. Um CEP como 01234 continua sendo texto, então o zero à esquerda é preservado.
- Indentação: 2 espaços, 4 espaços ou uma tabulação para um arquivo que pessoas vão ler; Minificado coloca tudo em uma linha e gera o menor arquivo.
- Ignorar linhas iniciais e Prefixo de comentário: descartam uma linha de título acima do cabeçalho real ou linhas que começam com #, para que não sejam lidas como nomes nem como dados.
Se o seu arquivo tiver mais de 25 MB, divida o CSV por número de linhas e converta as partes, mantendo o cabeçalho em cada uma. Se você ainda está decidindo se XML é o formato certo, JSON, CSV ou XML compara os três; para dados que já estão em JSON, use JSON para XML.
Perguntas frequentes
Como converto um arquivo CSV para XML de graça?
Solte o CSV no conversor de CSV para XML, defina os nomes do elemento raiz e do elemento de linha, escolha elementos ou atributos, confira a prévia de vinte linhas e baixe o XML. Um arquivo de até 25 MB é grátis, com todas as configurações que afetam o próprio XML.
Como uso a linha de cabeçalho do CSV como tags XML?
Mantenha Primeira linha como nomes de elemento ligada. Cada cabeçalho vira o nome de um elemento filho, corrigido onde o XML o rejeitaria; por exemplo, 2024 vira _2024. Se desligar, as colunas se chamam column_1, column_2 e assim por diante.
Por que meu XML aparece como mal formado?
Geralmente por um nome de tag que viola as regras do XML, um & ou < sem escape em um valor ou um caractere de controle perdido. O conversor corrige nomes, escapa valores e remove caracteres inválidos, então a saída dele é bem formada. Se um arquivo feito em outro lugar falhar, converta o CSV de novo aqui.
Posso deixar algumas colunas como atributos e outras como elementos?
Sim. Defina o padrão em Escrever colunas como e depois mude qualquer coluna na tabela Colunas para Elementos, Atributos, CDATA ou Ignorar. Tudo isso é grátis.
Por que os acentos aparecem errados no meu XML?
O CSV foi lido com a codificação errada. O XML é gravado em UTF-8, então o estrago aconteceu na leitura. Ajuste Codificação para UTF-8, Windows-1252 ou UTF-16 conforme o CSV foi salvo e confira na prévia uma linha com acentos.
Posso converter vários CSV de uma vez ou criar XML aninhado?
Esses são recursos Pro: até 50 arquivos de uma vez baixados em um único ZIP, agrupamento de linhas por uma coluna-chave para XML aninhado, um namespace e um esquema XSD gerado. A versão gratuita converte um arquivo por vez em XML plano.