O que é Base64? Codificação, preenchimento e quando usar

Dados binários não viajam por sistemas só de texto, então os escrevemos com 64 caracteres seguros. Aprenda como três bytes viram quatro caracteres, o que significa o preenchimento com = e por que Base64 não é criptografia.

📂 Fundamentos para desenvolvedores ⏱ Cerca de 8 minutos 📶 Iniciante 🛠️ Combina com: codificador Base64

O que você vai aprender

  • Explicar por que dados binários precisam de uma codificação de texto
  • Calcular como 3 bytes viram 4 caracteres Base64
  • Ler o preenchimento (=, ==) e saber quando ele aparece
  • Diferenciar Base64 de Base64URL — e saber qual um JWT usa
  • Saber onde o Base64 cabe (e onde não cabe)
Neste guia
  1. O que é Base64 — e por que existe
  2. Como funciona, passo a passo
  3. Base64 vs Base64URL
  4. Onde você realmente encontra o Base64
  5. O que o Base64 não é
  6. Erros comuns
  7. Teste: codificador Base64
  8. Perguntas frequentes

O que é Base64 — e por que existe

Muitos sistemas só lidam com texto: corpos de e-mail, JSON, URLs, XML, código-fonte. Dados binários — uma imagem, um arquivo, uma assinatura criptográfica — contêm bytes que esses sistemas corromperiam ou rejeitariam (um byte zero, um caractere de controle, um byte que não é UTF-8 válido).

Base64 é uma forma de soletrar bytes arbitrários usando apenas 64 caracteres seguros: A–Z, a–z, 0–9, além de + e / (com = para preenchimento) codificação, não criptografia: qualquer um pode decodificá-lo, por design.

O nome já entrega: 64 caracteres significa que cada caractere carrega 6 bits de informação (26 = 64). Três bytes são 24 bits; 24 ÷ 6 = 4 — então cada 3 bytes de entrada viram exatamente 4 caracteres de saída. Essa proporção de 4:3 é o motivo de a saída Base64 ser sempre cerca de 33% maior que a entrada.

Como funciona, passo a passo

Pegue a palavra Man — bytes M (77), a (97), n (110):

M   = 01001101
    a   = 01100001
        n   = 01101110
Joined:  010011 010110 000101 101110
          T      W      F      u
Result:  TWFu

Os 24 bits são divididos em quatro grupos de 6 bits, e cada grupo aponta para o alfabeto (A=0, B=1, … Z=25, a=26, … 0=52, +=62, /=63). A decodificação é o inverso: procure cada caractere, remonte os bits e divida novamente em bytes.

Quando a entrada não é múltipla de 3 bytes, o último grupo é preenchido com bits zero e a saída é preenchida com = para que o comprimento continue múltiplo de 4:

EntradaBytesSaídaPreenchimento
Man3TWFunenhum
Ma2TWE=um =
M1TQ==dois =

O preenchimento não é decoração: ele diz ao decodificador exatamente quantos bytes o último grupo realmente continha. Alguns sistemas (notadamente o JWT) removem o preenchimento e deixam o decodificador deduzir pelo comprimento — Base64URL válido, mas não Base64 estrito.

Base64 vs Base64URL

Caracteres 62 e 63PreenchimentoUsado em
Base64 (padrão)+ e /= mantidoE-mail (MIME), data URIs, XML
Base64URL- e _geralmente removidoJWT, URLs, nomes de arquivo

A variante para URL existe porque + significa “espaço” em query strings e / é um separador de caminho — Base64 padrão em uma URL ficaria corrompido. Misturar os dois alfabetos é um erro clássico: decodificar Base64URL com um decodificador padrão falha no primeiro -. Se o seu código lida com tokens (JWTs) e arquivos (MIME) no mesmo lugar, mantenha os dois decodificadores separados.

Onde você realmente encontra o Base64

  • Anexos de e-mail (MIME). O e-mail foi projetado para texto; os anexos são codificados em Base64 dentro do corpo da mensagem. É por isso que um anexo de 10 MB transforma um e-mail em algo de aproximadamente 13 MB.
  • Data URIs. data:image/png;base64,iVBORw0… incorpora uma imagem pequena diretamente em HTML ou CSS — uma requisição a menos, ao custo de 33% de bytes extras. Bom para ícones minúsculos, terrível para fotos.
  • JWTs. O cabeçalho e o payload de um JSON Web Token são Base64URL — e é por isso que qualquer um pode decodificá-los (veja nosso guia de JWT).
  • HTTP Basic Auth. Authorization: Basic dXNlcjpwYXNz é apenas user:pass em Base64 — ofuscado, não protegido. Sem HTTPS, é trivialmente legível.
  • Incorporar binário em JSON ou configuração. Chaves pequenas, certificados e miniaturas viajam como strings Base64 porque o JSON não tem tipo binário.

O que o Base64 não é

Não é criptografia. Não há chave nem segredo — a decodificação é uma tabela de consulta que qualquer um pode aplicar. Tratar Base64 como “esconder” dados é um bug de segurança, não um recurso.

Não é compressão. A saída é sempre maior — cerca de 33% maior, além do preenchimento. Se o tamanho importa, comprima primeiro (gzip) e só depois codifique, se precisar; nunca codifique esperando economizar espaço.

Não é um hash. Um hash é unidirecional e de tamanho fixo; o Base64 é totalmente reversível e cresce com a entrada. Confundir os três — codificação, criptografia, hashing — é um dos mal-entendidos de segurança mais comuns em software.

Erros comuns

  • Tratar Base64 como segurança. “Nós codificamos a senha em Base64” é texto puro com passos extras.
  • Esquecer o preenchimento. Decodificadores estritos rejeitam entrada sem preenchimento; os tolerantes aceitam. Saiba qual é o seu antes de remover =.
  • Misturar os alfabetos padrão e URL-safe. +// vs. -/_ — escolha o decodificador certo para os dados que você tem.
  • Codificar texto sem fixar o conjunto de caracteres primeiro. Base64 codifica bytes, não caracteres: “café” em UTF-8 e em Latin-1 geram saídas diferentes. Sempre codifique UTF-8 explicitamente.
  • Codificar arquivos grandes em Base64 dentro do HTML. Uma foto de 2 MB vira 2,7 MB de texto na sua página, sem cache e lenta. Vincule o arquivo em vez disso.

Teste: codificador Base64

Codifique seu próprio texto com o codificador Base64 e decodifique-o de volta — depois experimente um arquivo de imagem e veja a saída crescer um terço, exatamente como este guia prevê.

Abrir o codificador Base64 →

Continue aprendendo

Perguntas frequentes

Por que a saída Base64 às vezes termina com = ou ==?

Preenchimento. A entrada é processada em grupos de 3 bytes; se o último grupo tiver 2 bytes, um = é adicionado, e se tiver 1 byte, dois ==. O preenchimento mantém o comprimento da saída múltiplo de 4 e diz ao decodificador quantos bytes o grupo final contém.

O Base64 é reversível?

Sim, completamente — é uma codificação, não criptografia nem hashing. Qualquer pessoa com a string pode decodificá-la sem chave. Nunca use para esconder nada.

Por que a saída Base64 é maior que a entrada?

Cada caractere de saída carrega 6 bits, mas ocupa 8 bits (um byte) de texto. 3 bytes (24 bits) viram 4 caracteres (32 bits) — uma sobrecarga de 33%, além de até 2 caracteres de preenchimento.

Qual é a diferença entre Base64 e codificação hex?

Ambos soletram bytes como texto. O hex usa 16 caracteres (0-9, a-f), então cada byte vira 2 caracteres — sobrecarga de 100%. O Base64 usa 64 caracteres, então cada 3 bytes viram 4 caracteres — sobrecarga de 33%. O hex é mais legível e mais fácil de comparar; o Base64 é mais compacto.

O Base64 pode codificar texto Unicode como chinês ou emoji?

Sim — mas ele codifica bytes, então o texto precisa primeiro ser convertido em bytes, quase sempre UTF-8. Os mesmos caracteres codificados como UTF-16 dariam um Base64 completamente diferente. Se a decodificação resultar em mojibake, a codificação de bytes estava errada, não o Base64.