URL 编码 / 解码

示例：中文搜索词放进查询参数

把用户输入的搜索词拼进 ?q= 之前，要先把它当作一个“值”编码，否则空格、&、= 会破坏 URL 的结构。

输入 北京 天气，默认输出 %E5%8C%97%E4%BA%AC%20%E5%A4%A9%E6%B0%94。每个汉字是 3 个 UTF-8 字节，变成 3 组 %XX；中间的半角空格变成 %20。

勾选「空格写成 +（表单数据）」后，同一个输入得到 %E5%8C%97%E4%BA%AC+%E5%A4%A9%E6%B0%94。这和浏览器提交 GET 表单、URLSearchParams 生成的写法一致。按表单格式解析查询串的服务端两种写法都能读；只做百分号解码的服务端（如直接调用 decodeURIComponent）会把 + 当成加号。签名校验类接口通常还要求逐字节一致，要先确认对方用的是哪一种。

解码方向同理：%E5%8C%97%E4%BA%AC+%E5%A4%A9%E6%B0%94 默认解码为 北京+天气，+ 原样保留；打开表单选项才会得到 北京 天气。

GBK 编码的旧链接

HTML 表单提交时，查询串按页面自己的字符编码来编码（HTML 标准 4.10.22.5 节：编码先取文档的字符编码）。所以早年以 GBK 编码的网页，提交出来的“北京”是 %B1%B1%BE%A9，而不是 UTF-8 的 %E5%8C%97%E4%BA%AC。

把 q=%B1%B1%BE%A9 放进解码框，工具不会显示乱码，而是停下来报 第 3 个字符起：%B1%B1%BE%A9 不是有效的 UTF-8。GBK 等其他编码的文本无法在这里解码。。位置从 1 开始按字符计数，q= 占了前两个。看到这条提示，说明这段字节来自 GBK 一类的旧编码，需要用能指定编码的程序处理，例如 Python 的 urllib.parse.unquote('%B1%B1%BE%A9', encoding='gbk')。

编码了两次

链接里出现 %25，通常是已经编码过的值又被编码了一次：% 本身被编码成 %25。

对 %E5%8C%97%E4%BA%AC 再编码一次，得到 %25E5%258C%2597%25E4%25BA%25AC。服务端只解码一次，拿到的就不是“北京”而是一串 %E5…。把这样的值放进解码框解一次，可以看到上一步的样子，再逐层排查是哪个环节多编码了一次。

什么时候用这个工具

• 查询参数的值里有空格、&、=、# 或中文时。
• 一个路径或 URL 要作为另一个 URL 的参数值传递时，例如登录后跳回的 redirect 参数：只编码放进 redirect= 的那个值。/zh/工具 编码后是 %2Fzh%2F%E5%B7%A5%E5%85%B7，斜杠也被编码，再拼成 https://example.com/login?redirect=%2Fzh%2F%E5%B7%A5%E5%85%B7。外层的 https://example.com/login?redirect= 不要编码。
• 不要用它处理准备直接打开的完整地址。整个地址编码后，: 和 / 也变成了 %XX，不再是可用的链接。要整理完整 URL，请用 URL 解析器逐个修改参数值。

限制

• 只支持 UTF-8，不会尝试猜测编码。GBK、GB18030 等编码的百分号序列通常会报错；少数字节恰好也是合法的 UTF-8，这时会解成别的字，工具不会提示。例如 GBK 的“模”是 %C4%A3，解码结果是 ģ。
• 解码遇到第一个问题就停止，并写出位置。100% 这类结尾孤立的 % 也算错误。
• 默认编码保留 ! ' ( ) * 不编码（encodeURIComponent 的规则）。有些签名算法要求把它们写成 %21 %27 %28 %29 %2A，需要手动替换。
• 没有 encodeURI 模式。
• 被截断的 emoji（孤立的代理项）无法编码，状态行会给出它的位置。