Codificação e Decodificação de URL
Codifique e decodifique strings de URL para lidar com segurança com caracteres especiais e texto não-ASCII, ideal para parâmetros de consulta e transmissão de caminhos.
Como Usar
A codificação de URL converte caracteres especiais ou não-ASCII no formato %XX para transmissão segura em URLs.
Use 'Codificar' para transformar o texto em um formato seguro para URL (ex.: para parâmetros de consulta).
Use 'Decodificar' para restaurar as sequências %XX aos seus caracteres originais.
Cenários comuns: tratamento de parâmetros de consulta, transmissão de dados de formulários, chamadas de API, etc.
Recursos
- Dois modos de codificação: encodeURIComponent e encodeURI
- Tratamento flexível de espaços: codifique como + ou %20
- Conversão em tempo real com estatísticas de comprimento de entrada/saída
- Botões de copiar/limpar e funcionalidade bidirecional de envio para o painel
- Suporte completo à internacionalização com multi-tema DaisyUI
O que é Codificação de URL?
A codificação de URL converte caracteres em sequências percent-encoded (%XX) para garantir uma transmissão segura nas URLs.
encodeURIComponent é adequado para componentes individuais (por exemplo, o valor de um único parâmetro de consulta) e codifica a maioria dos caracteres não alfanuméricos.
encodeURI foi projetado para strings URI completas e preserva caracteres reservados com significado estrutural, como ?, &, = e /.
Casos de Uso Comuns
- Construção de parâmetros de consulta (por exemplo, palavras-chave de busca, condições de filtro)
- Codificação e transmissão de dados de formulários via GET/POST
- Codificação de parâmetros de requisição da API
- Inserção segura de entradas do usuário em segmentos de caminho da URL
FAQs e Armadilhas
- encodeURI vs encodeURIComponent: Use a codificação de componente para partes individuais e a codificação de URI para URLs inteiras
- Espaços e +: Em application/x-www-form-urlencoded, os espaços são comumente representados como + nas strings de consulta
- Evite decodificação dupla: A decodificação repetida pode corromper os dados
- Sequências de percentuais inválidas geram erros; trate as exceções de forma adequada
Como Realizar a Codificação/Decodificação de URL em Linguagens de Programação
JavaScript
Codificar
// Component (recommended for query values)
const encoded = encodeURIComponent(text);
// If you need '+' for spaces in query strings
const encodedPlus = encoded.replace(/%20/g, '+');
// Full URI
const encodedUri = encodeURI(url);
Decodificar
// Treat '+' as space if needed
const input = plusAsSpace ? s.replace(/\+/g, ' ') : s;
// Component
const dec1 = decodeURIComponent(input);
// Fallback to decodeURI when input is a full URL
const dec2 = decodeURI(input);
PHP
Codificar
// Component (RFC 3986)
$encoded = rawurlencode($text);
// '+' for spaces (application/x-www-form-urlencoded)
$encodedPlus = str_replace('%20', '+', $encoded);
// Full query usage
$query = http_build_query(['q' => '你好 世界', 'type' => 'text']);
Decodificar
// Component
$decoded = rawurldecode($s);
// If input uses '+' for spaces
$decodedPlus = urldecode($s);
Python
Codificar
from urllib.parse import quote, quote_plus
# Component (RFC 3986)
enc = quote(text, safe='')
# '+' for spaces (application/x-www-form-urlencoded)
enc_plus = quote_plus(text)
Decodificar
from urllib.parse import unquote, unquote_plus
# Component
dec = unquote(s)
# Input with '+' for spaces
dec_plus = unquote_plus(s)
Go
Codificar
import (
"net/url"
)
// Query component
enc := url.QueryEscape(text) // spaces => +
// Path segment
// go1.8+
// url.PathEscape(text)
Decodificar
import (
"net/url"
)
// Query component
dec, _ := url.QueryUnescape(s)
// Path segment
// url.PathUnescape(s)
Rust
Codificar
// Cargo.toml: urlencoding = "^2"
use urlencoding::{encode, encode_binary};
let enc = encode(text); // component; spaces => %20
let enc_plus = enc.replace("%20", "+"); // if you need '+' for spaces
Decodificar
use urlencoding::decode;
// decode treats '+' as space
let dec = decode(s)?; // Result, _>
Java
Codificar
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
// Query param / form style (spaces => '+')
String enc = URLEncoder.encode(text, StandardCharsets.UTF_8);
// For RFC3986-like component encoding, replace '+' with %20 if needed
String encSpace = enc.replace("+", "%20");
Decodificar
import java.net.URLDecoder;
import java.nio.charset.StandardCharsets;
// URLDecoder treats '+' as space
String dec = URLDecoder.decode(s, StandardCharsets.UTF_8);