ToolMill.io

URL Codificar / Decodificar (porcentagem de codificação)

URL Code/Decode (percent-encoding) converte caracteres inseguros em um formato seguro para URL e volta novamente. Use-o para strings de consulta, redirecionar URLs, parâmetros UTM e pedidos de depuração de API (RFC 3986). Executa 100% localmente em seu navegador — sem uploads — e funciona offline após instalar ToolMill como um PWA.

Codificação

Experimenta.

Exemplos

Texto do código URL para um parâmetro de pesquisa
Entrada
summer sale & shoes
Saída
summer%20sale%20%26%20shoes
Texto de URL codificado por cento
Entrada
summer%20sale%20%26%20shoes
Saída
summer sale & shoes

Quando codificar um valor completo vs parte de um URL

O erro mais comum com a codificação de porcentagem é a codificação da parte errada de um URL. Em muitos fluxos de trabalho, você só quer codificar um valor de consulta, segmento de caminho, fragmento ou redirecionar o alvo ao invés de toda a string de URL. Esta página usa encodeURIComponent e decodeURIComponent, que são mais adequados para valores e componentes individuais.

Caracteres que normalmente precisam de codificação

Espaços, ampersands, é igual a sinais, pontos de interrogação, hashes, sinais percentuais, cortes nos valores dos componentes e caracteres não ASCII são motivos comuns para codificar texto antes de colocá-lo dentro de uma URL. Isso é especialmente importante para pesquisas, rótulos, nomes de arquivos e valores fornecidos pelo usuário que de outra forma quebrariam uma string de consulta ou segmento de caminho.

Erros comuns com codificação de URL

A codificação dupla é um dos problemas mais comuns. Por exemplo, um %20 existente codificado torna-se novamente %2520. Outro erro comum é decodificar uma URL inteira quando apenas um valor de parâmetro deve ser decodificado. Também é importante lembrar que esta página produz espaços codificados por cento como% 20, não form-style mais sinais.

Fluxos de trabalho práticos

Use esta página ao preparar um parâmetro de consulta para um link, limpar valores UTM ou rastrear, decodificar texto codificado por cento copiado de logs ou ferramentas do navegador, ou fazer um segmento de caminho seguro antes de inseri-lo em outra URL. É muito útil quando você está lidando com um valor de cada vez e quer ver o resultado exato por cento codificado.

O que acontece com texto não-inglês e emoji

Essa ferramenta codifica os bytes UTF-8, razão pela qual caracteres acentuados, texto não-latino e emoji muitas vezes se tornam múltiplos códigos percentuais em vez de uma única unidade. Esse comportamento é normal e útil quando o destino espera uma representação segura de URL do texto original do Unicode.

Erros de decodificação

Antes de Você Confiar em um valor codificado por URL

Teste a saída no contexto de destino real antes de assumir que está correta. Se algo ainda parecer errado, verifique se há codificação dupla, manipulação mista de espaços e mais sinais, ou um descompasso entre como seu destino trata URLs completas versus valores de parâmetros individuais.

Por que o texto decodificado ainda pode ser errado para sua aplicação

A decodificação correta aqui não garante que outro aplicativo interprete o texto da mesma forma. Alguns sistemas tratam mais sinais como espaços, outros os preservam literalmente, e caracteres reservados ainda podem precisar de manipulação especial, dependendo se o texto pertence a um caminho, string de consulta ou submissão de formulário.

Como dizer se você deve codificar um URL completo ou apenas uma parte

As necessidades de codificação dependem do contexto. Um valor de parâmetro de consulta muitas vezes precisa de codificação mesmo quando o resto do URL deve permanecer legível, enquanto um URL já montado pode quebrar se você codifica separadores como ?, &, =, ou /. Pense se você está preparando um componente ou o endereço inteiro antes de usar o resultado.

Falhas de decodificação geralmente significam que o texto colado contém sequências porcentárias malformadas, conteúdo simples e codificado misto, ou uma string que já foi decodificada uma vez. Se o resultado parecer errado, verifique se você colou uma URL completa em vez de um único componente e se os sinais percentuais foram dobrados pelo processamento anterior.

Ferramentas relacionadas