O que é Base64
Base64 é uma forma de codificar dados binários em 64 caracteres imprimíveis (A-Z, a-z, 0-9, +, /). Não é criptografia, apenas "uma outra forma de escrever", permitindo que dados binários sejam transmitidos por canais de texto. Após a codificação, o tamanho dos dados aumenta cerca de 33%.
Por que usar Base64
Muitos sistemas suportam apenas transmissão de texto, como e-mail, JSON, URL, XML. Para transmitir imagens, áudio e arquivos binários por esses canais, é preciso primeiro codificá-los em texto. Base64 é a solução mais universal.
Usos comuns
1. Anexos de e-mail
O protocolo de e-mail originalmente suportava apenas texto ASCII; anexos (imagens, documentos) precisam ser codificados em Base64 antes da transmissão.
2. Data URI / imagens inline
Imagens convertidas em Base64 podem ser embutidas diretamente em HTML/CSS, reduzindo requisições HTTP. Veja o guia de uso de imagens Base64.
3. Transmissão de dados por API
JSON não suporta binários; ao transmitir imagens ou arquivos, codifique-os em Base64 como string e inclua no JSON.
4. Armazenamento em variáveis de ambiente
Configurações binárias, como certificados e chaves, são codificadas em Base64 e armazenadas em variáveis de ambiente.
Ferramenta de codificação e decodificação Base64 do DocsAll
Use a ferramenta de codificação e decodificação para operar com um clique:
- Abra a ferramenta de codificação e decodificação
- Selecione o modo Base64
- Cole o texto → clique em "Codificar" para obter o Base64; ou cole o Base64 → clique em "Decodificar" para restaurar
- Copie o resultado
A ferramenta também suporta codificação de URL e codificação de entidades HTML, cobrindo necessidades comuns.
Exemplo de codificação
O texto Hello, após codificação, fica SGVsbG8=. Note o sinal de igual no final: Base64 usa sinais de igual para completar os dígitos, não é um erro.
Armadilhas comuns
Base64 não é criptografia
Qualquer pessoa pode decodificá-lo; nunca o use para "criptografar" dados sensíveis. Para criptografia, use algoritmos como AES e RSA.
O tamanho aumenta 33%
Após a codificação Base64, cada 3 bytes vira 4 caracteres, aumentando o custo de transmissão e armazenamento. Use com cuidado em arquivos grandes.
Problemas de conjunto de caracteres
O Base64 padrão contém + e /, o que causa problemas em URL. Em cenários de URL, use Base64 seguro para URL (substituindo + por - e / por _).
Quebras de linha
Algumas implementações de Base64 inserem uma quebra de linha a cada 76 caracteres; ao decodificar, geralmente as quebras devem ser ignoradas. Se a decodificação falhar, verifique primeiro se há quebras de linha ou espaços extras.
Sugestões práticas
- Antes de codificar, confirme se os dados são texto ou binário e escolha o modo correto
- Se a decodificação falhar, verifique primeiro se os caracteres estão completos e se há espaços ou quebras de linha
- Não use Base64 inline para arquivos grandes; o aumento de tamanho é muito grande
Dominar Base64 facilita muito a depuração front-end e back-end e a transmissão de dados.