URL 编码器（百分号编码）

如何对字符串进行 URL 编码

1. 在 文本或 URL 中输入或粘贴文本。输出会随输入实时更新。
2. 在 编码方式 下选择模式：
   • 组件（encodeURIComponent）：用于单个查询参数值、表单字段或路径片段。
   • 完整 URL（encodeURI）：用于包含空格或非 ASCII 字符的完整 URL。
   • 表单数据（空格转为 +）：用于 application/x-www-form-urlencoded 正文，以及按 HTML 表单方式构造的查询字符串。
   • 所有字符：对所有字节（包括字母）做百分号编码，用于测试解码器。
3. 字符集 保持 UTF-8 即可，除非接收方系统需要传统编码。
4. 勾选 逐行处理 可以一次编码一组值，然后点击 复制输出。互换 会把结果送到解码器，检查往返转换是否一致。

输入为完整 URL 时，还会在输入输出框下方的表格中把它拆分为协议、主机、路径、每个查询参数和片段。

encodeURIComponent、encodeURI 与表单编码对比

同一个输入 a b&c=d/é?#+，三种常见方式的结果：

组件 只保留 A–Z a–z 0–9 - _ . ! ~ * ' ( ) 不转义。完整 URL 还会保留 ; / ? : @ & = + $ , #，也就是构成 URL 结构的字符，所以它无法保护包含这些字符的值。表单数据 只保留字母、数字和 - _ . *，并把空格写成 +。

经典的 bug 是用 完整 URL 编码来拼接 URL：?q=C++ & Go 会保留 + 和 &，服务器收到的是 q=C 加一个多余的参数。正确的做法是用 组件 编码这个值：?q=C%2B%2B%20%26%20Go。

空格、加号和其他麻烦字符

URL 中的 Base64 是 +、/ 和 = 问题的常见场景。要么把它作为组件做百分号编码，要么改用 Base64URL，它不使用这些字符。

非 UTF-8 字符集

百分号编码作用于字节，所以结果由字符集决定。é 在 UTF-8 中是 %C3%A9，在 Windows-1252 或 ISO-8859-1 中是 %E9。现代浏览器和 API 使用 UTF-8，但较老的 PHP 应用、部分支付网关和传统内网系统仍然需要 Latin-1 或 Windows-1252，日文网站有时用 Shift_JIS，一些老的中文系统则用 GBK。在 字符集 下选择对应的字符集即可。所选字符集中不存在的字符无法表示，请检查输出中是否有这类字符。

在代码中进行 URL 编码

encodeURIComponent("a b&c")              // "a%20b%26c"
new URLSearchParams({ q: "C++ & Go" }).toString()   // "q=C%2B%2B+%26+Go"

from urllib.parse import quote, quote_plus, urlencode
quote("/files/a b.txt")            # '/files/a%20b.txt'  (keeps / by default)
quote("/files/a b.txt", safe="")   # '%2Ffiles%2Fa%20b.txt'
quote_plus("a b&c")                # 'a+b%26c'
urlencode({"q": "C++ & Go"})       # 'q=C%2B%2B+%26+Go'

Python 的 quote 默认保留 /，除非传入 safe=""，编码值时这一点经常让人意外。其他语言：PHP 的 rawurlencode 生成 %20，urlencode 生成 +；Java 的 URLEncoder.encode 是带 + 的表单编码；Go 有 url.PathEscape（%20）和 url.QueryEscape（+）。encodeURIComponent 不转义 ! ' ( ) *；如果需要严格符合 RFC 3986 的输出，事后再替换它们：

const strict = s => encodeURIComponent(s).replace(/[!'()*]/g,
  c => "%" + c.charCodeAt(0).toString(16).toUpperCase());

JavaScript 方面的更多内容见 JavaScript Base64 页面。要反向还原，请使用 URL 解码器。

常见问题