URL 编码/解码工具（URL Encoder/Decoder）

两个函数都会把安全字符集之外的每个字符转成 UTF-8 字节，每个字节写成 % 加两位十六进制数字。区别在于哪些字符保持不变：

• encodeURIComponent 只保留 A–Z a–z 0–9 - _ . ! ~ * ' ( )。凡是放进 URL 内部的内容都该用它：查询参数值、路径片段、表单字段。&、=、?、/、# 这些字符会被编码，不会把 URL 拆坏。
• encodeURI 还额外保留 ; , / ? : @ & = + $ #，所以完整 URL 编码后仍然能用。千万别用它编码单个值：Tom & Jerry 里的 & 会原样留下，把查询字符串拆成两段。

一个汉字占 3 个 UTF-8 字节，编码后变成 9 个字符；带重音的拉丁字母占 2 个字节。可读的 ASCII slug 就没有这个问题，参见如何音译 slug。

在 URL 路径里以及用 encodeURIComponent 时，空格是 %20。HTML 表单以 application/x-www-form-urlencoded 格式提交数据，空格写成 +，真正的加号写成 %2B：a b+c 会变成 a+b%2Bc。编码或解码表单数据时，打开「空格转为 +」。不打开时，解码会把 + 当作加号保留，与 decodeURIComponent 完全一致。

decodeURIComponent 遇到两类输入会抛出 URIError，本工具会改为报告准确位置：

• % 后面没有两位十六进制数字。 100% 或 %zz 都不是有效转义。如果原意是字面的百分号，应该编码成 %25。
• 字节不是 UTF-8。 %E4%B8 是被截断的汉字（需要 3 个字节），caf%E9 则是用 Latin-1 而不是 UTF-8 编码的。请把原文重新按 UTF-8 编码，或补全被截断的部分。

打开「逐行处理」时，失败的行原样保留，其余各行照常解码。

对已经编码过的字符串再编码一次，每个 % 都会变成 %25：é 编码成 %C3%A9，再编码就成了 %25C3%25A9。常见原因是你的代码编码了一次，库或 CMS 又编码了一次。当你编码的文本里已经有转义时，工具会提醒；解码后的文本看起来仍是编码状态时，会提供「彻底解码」，反复解码直到不再变化：caf%25C3%25A9 → caf%C3%A9 → café。

下面的函数与工具输出完全一致（已对每个测试字符串逐一核对）：

// Query values, path segments, form fields: encode everything except A-Z a-z 0-9 - _ . ! ~ * ' ( )
encodeURIComponent('Café & Bar?');   // 'Caf%C3%A9%20%26%20Bar%3F'
decodeURIComponent('Caf%C3%A9');     // 'Café' (throws URIError on bad input such as '100%')

// A whole URL: keeps ; , / ? : @ & = + $ # so the URL still works
encodeURI('https://example.com/a b?q=café'); // 'https://example.com/a%20b?q=caf%C3%A9'

from urllib.parse import quote, unquote

def encode_uri_component(s):  # same output as JavaScript's encodeURIComponent
    return quote(s, safe="-_.!~*'()")

def encode_uri(s):  # same output as JavaScript's encodeURI
    return quote(s, safe="-_.!~*'();,/?:@&=+$#")

def decode_uri_component(s):  # raises on invalid UTF-8 such as '%E9'; a stray '%' is kept as is
    return unquote(s, errors='strict')

<?php
// rawurlencode() also encodes ! * ' ( ); put them back to match encodeURIComponent exactly.
function encode_uri_component(string $s): string {
    return strtr(rawurlencode($s), ['%21' => '!', '%2A' => '*', '%27' => "'", '%28' => '(', '%29' => ')']);
}

function decode_uri_component(string $s): string {
    return rawurldecode($s); // keeps "+" as "+"; use urldecode() for form data
}

做 URL slug 时其实很少需要编码：URL Slug 生成器 会把标题转成用连字符连接的小写 ASCII 单词，根本不需要转义。如果只想去掉文本里的重音而不生成 slug，请用去除重音符号工具。

• MDN：encodeURIComponent() 和 encodeURI()
• RFC 3986：Uniform Resource Identifier，第 2 节 Characters
• Python 文档：urllib.parse.quote()