Como converter encoding de arquivo com iconv

Como Converter Encoding de Arquivo com iconv no SSH (Guia para Iniciantes)

Olá, amigo(a) GeHost! Seja muito bem-vindo(a) ao nosso Sensei da Tecnologia — aqui, você aprende com calma, com carinho, e sem pressa. Hoje vamos aprender algo poderoso, mas simples: como converter o encoding de um arquivo usando o comando iconv no SSH.

Imagine que você tem um arquivo de texto (como um CSV ou um documento de importação) que está com caracteres estranhos: á virou á, ç virou ç, ou até palavras inteiras parecem "quebradas". Isso geralmente acontece por causa de encoding incorreto — o sistema não entende qual "idioma de caracteres" o arquivo está usando.

Com o iconv, você pode converter esse arquivo de um encoding para outro — como de ISO-8859-1 para UTF-8, por exemplo — e resolver tudo de forma rápida e eficiente.

Dica do Sensei: O iconv é uma ferramenta poderosa que já vem instalada em quase todos os servidores Linux. Você só precisa acessar o servidor via SSH e digitar alguns comandos simples. Vamos lá!

Passo a Passo: Convertendo Encoding com iconv

1. Entre no seu servidor via SSH

   Use seu cliente SSH favorito (como PuTTY, Terminal do Mac ou Windows Terminal) e conecte-se ao seu servidor. Você precisará do usuário e da senha da sua conta GeHost.

   

2. Localize o arquivo que quer converter

   No terminal, use o comando ls para listar os arquivos na pasta atual. Se o arquivo estiver em outra pasta, use cd para navegar. Exemplo:

   ls

   Suponha que seu arquivo se chame dados.csv.

3. Verifique o encoding atual do arquivo

   Use o comando file para descobrir qual encoding o arquivo está usando. Digite:

   file -i dados.csv

   Exemplo de saída:

   dados.csv: text/plain; charset=iso-8859-1

   Isso mostra que o arquivo está no encoding ISO-8859-1 (comum em arquivos antigos).

4. Converta o arquivo para UTF-8

   Agora, vamos converter o arquivo de ISO-8859-1 para UTF-8 — o padrão moderno que suporta todos os idiomas, inclusive português com acentos.

   Digite o comando abaixo:

   iconv -f ISO-8859-1 -t UTF-8 dados.csv -o dados_convertidos.csv

   Explicando:

   • -f ISO-8859-1 → fonte (encoding atual)
   • -t UTF-8 → destino (novo encoding)
   • dados.csv → arquivo original
   • -o dados_convertidos.csv → nome do novo arquivo com encoding correto

   O arquivo original não é alterado — você cria um novo com o encoding certo.

5. Verifique o novo arquivo

   Use o comando file -i novamente para confirmar:

   file -i dados_convertidos.csv

   Agora você verá:

   dados_convertidos.csv: text/plain; charset=utf-8

   Pronto! Seu arquivo está no encoding correto.

6. Substitua o arquivo original (opcional)

   Se você tiver certeza de que o novo arquivo está correto, pode substituir o antigo:

   mv dados_convertidos.csv dados.csv

   Pronto! Agora seu arquivo original foi atualizado com o encoding correto.

Exemplos comuns de encoding

• ISO-8859-1 (ou Latin-1): usado em arquivos antigos, especialmente em países de língua portuguesa.
• UTF-8: o padrão moderno. Suporta todos os idiomas, acentos, emojis e caracteres especiais.
• Windows-1252: comum em arquivos criados no Windows.

Atenção do Sensei: Sempre faça backup antes de converter arquivos importantes. Se algo der errado, você pode restaurar o original.

Conclusão

Converter encoding com iconv é uma habilidade simples, mas extremamente útil — especialmente se você trabalha com arquivos de importação, planilhas, ou dados de clientes.

Se você seguir esses passos com calma, vai ver que o poder da tecnologia está ao seu alcance. E lembre-se: todo grande programador começou onde você está agora — com um comando simples, um pouco de coragem e muita curiosidade.

Se tiver dúvidas, é só chamar o nosso suporte. Aqui na GeHost, estamos sempre prontos para ajudar — como um bom amigo, como um verdadeiro Sensei.