编码/解码

URL 编解码

URL 编码(百分号编码)与解码

编码方式:
原始文本/URL
URL 编码结果
结果将显示在这里

什么是 URL 编码?

URL 编码(也称为百分号编码)是一种将特殊字符转换为 %XX 格式的编码方式。由于 URL 只能使用 ASCII 字符集,非 ASCII 字符和一些保留字符需要进行编码后才能在 URL 中安全传输。

编码方式说明

  • encodeURIComponent:编码 URL 参数值,会编码大多数特殊字符(推荐用于参数值)
  • encodeURI:编码整个 URL,保留 URL 结构字符(: / ? # @ 等)
  • 全部编码:编码所有非字母数字字符,最严格的编码方式

使用场景

  • 构建 URL 查询参数:确保参数值不会破坏 URL 结构
  • API 请求:编码请求参数中的特殊字符
  • 跨系统数据传输:确保数据在不同系统间正确传递
  • 调试分析:解码已编码的 URL 查看原始内容

常见编码字符

  • 空格 → %20 或 +
  • 中文字符 → UTF-8 编码后转 %XX
  • & → %26
  • = → %3D
  • / → %2F

百分号编码工具:把 UTF-8 字节中非保留字符之外的内容改写成 %XX 并支持反向解码,三种模式分别对应参数值编码、整条 URL 编码与逐字符编码。常用于拼装查询串、阅读日志里的编码链接、排查二次编码。

三种编码方式各自放过哪些字符

百分号编码作用于字节而非字符:一个汉字占 3 字节,编成 3 个 %XX;一个四字节 emoji 编成 12 个字符。转义集合由 ECMA-262 规定:encodeURIComponent 只放过 A–Z、a–z、0–9 与 ' ( ) * - . _ ! ~ 九个符号;encodeURI 另保留 ; / ? : @ & = + $ , #,整条 URL 编码后仍可解析。第三种「全部编码」把非字母数字一律交给 encodeURIComponent,而后者本就不转义那九个符号,所以它的输出与第一种完全相同,标点也不例外,这是三种模式唯一的实质差别。

解码为什么报错而不是给出乱码

解码对整个字符串执行 decodeURIComponent:十六进制大小写都接受,再按 UTF-8 还原,故 %E5%A4%A9 与 %e5%a4%a9 得到同一字符。序列不完整或不合法即抛 URIError:结尾孤立的 %、坏十六进制 %zz、残缺首字节 %E4、单独的 %FF。JavaScript 抛异常而不替换成 U+FFFD,所以界面报错而非乱码;别处出现 �,说明那里在失败时用了替换字符。由此衍生两个现象:+ 始终是加号(只有表单解码才当空格),正文里一个百分号就足以让整串解不出来。

URL 解析面板何时出现

解析面板只在解码模式、且输入满足浏览器 URL 构造器的绝对 URL 语法时出现。裸查询串 q=%E5%A4%A9 或相对路径会抛 TypeError,面板保持空白,补上协议前缀即可。成功时列出协议、主机、路径、锚点与逐对还原的参数,但不单列 userinfo,端口并进 host。构造器还会归一化:.. 段被消解,路径里的 %7E 保持编码形态不解码。参数走 URLSearchParams,其中 + 会被还原成空格,与主输出区不一致。

实操示例

编码含中文、空格与保留字符的查询值

输入
搜索 天气&lang=zh
输出
%E6%90%9C%E7%B4%A2%20%E5%A4%A9%E6%B0%94%26lang%3Dzh

输入共 21 个 UTF-8 字节,输出 51 个字符:4 个汉字各占 3 个三元组(共 36 字符),空格编码为 %20 而不是 +,字面的 & 与 = 因为是保留字符而变成 %26、%3D。若改用 encodeURI 编码同一串,这两个字符会原样留下,这也是用错模式时参数值被拆成两个参数的原因。

边界与常见误用

  • 第三种模式并不比第一种严格:它把每个非字母数字字符直接交给 encodeURIComponent,因此 - _ . ! ~ * ' ( ) 仍然不转义,输出与第一种逐字节相同。若签名方只接受 RFC 3986 的非保留字符,需要自己再转义 ! * ' ( )。
  • 解码固定使用 decodeURIComponent,+ 不会变成空格;表单来源的串(如 a+b)要先自行替换再粘贴。
  • 只要出现一个非法三元组——孤立的 %、非十六进制字符、或无法构成合法 UTF-8 的字节——整串都解不出来,且提示只有一句通用失败信息,不指出出错位置。
  • 编码遇到不成对的代理码元会抛 URIError(按码元截断字符串或剪贴板数据损坏时常见),此时不会产出任何 %XX 结果。
  • 解析面板要求绝对 URL:裸查询串与相对路径会被 URL 构造器拒绝,而这两种恰恰是最常被粘贴进去的形式。

相关工具

选哪一档编码,以及什么时候该走开

你的情形这个 URL 编解码工具该换的方案
要编的值里本身就带 &、= 或 ?默认的 encodeURIComponent 一档会把它们写成 %26、%3D、%3F,服务端仍旧只看到一个值;换成 encodeURI 一档,这三个字符原样留下,这个值到对面就被切成多出来的参数,而且不报错。值要从好几个字段拼出来时,用 new URLSearchParams({ q: value }).toString(),它只转义值。手上已经是一个成型的具体值时,才用本页。
接收端是表单解码器,指望空格是 +三档都走 encodeURI 系列,空格一律出成 %20,从不出 +。这是保守的选择:%20 在原始解码器和表单解码器下都成立,+ 只在后者下才是空格。要 + 就得整包交给表单编码器:URLSearchParams、application/x-www-form-urlencoded 请求体、PHP 的 http_build_query。整条请求本身就是表单时用它,接收端可能按原始方式解码时坚持 %20。
想把 URL 拆开看结构,而不只是让它变得可读解析面板只读:协议、主机、路径、锚点和参数对摊开成文本,端口留在 host 里,userinfo 不显示,想改其中任何一处都得回页面外手工重新拼。URL 解析工具的参数表改完能直接拿回一条 URL。读一串编码留在本页,修一条链接换它。
字符串来自还在用 GBK 或 Shift-JIS 的老系统解码固定按 UTF-8 还原字节。%C4%E3(GBK 的「你」)过不了这道校验,整串直接报「无效的 URL 编码字符串」;碰上恰好构成合法 UTF-8 的字节对则不报错,直接给错字。用指定编码解:python3 -c "import urllib.parse;print(urllib.parse.unquote(s, encoding="gbk"))" 或 iconv -f gbk -t utf-8。来源早于 UTF-8 就别在本页硬解——这里没有编码选项,也不会去猜。
几百行日志都要做同一次转换一次粘贴一次来回,全部在标签页里算,没有批量入口,也不留转换记录。jq -sRr @uri 逐行编码,只放过 A–Z a–z 0–9 - _ . ~;Python 的 urllib.parse.quote 默认 safe="/",斜杠不会被转义,必须显式写 safe=""。先在本页核对一行,再交给命令行批量跑。
目标是 HTML 属性值或 JSON 字符串,不是 URI 的一段< 在这里会变成 %3C,HTML 把它当普通文本渲染出来,浏览器自始至终没见过尖括号——转义做了,但对象错了。要在 HTML 里显示,用 HTML 实体编码;字符串要塞进 JSON,用 JSON 字符串转义(\"、\n)。只有落点是 URI 组件时,百分号编码才是答案。

一个具体场景

一条要发出去的中文搜索链接

你准备发到群里的链接是 https://example.com/s?q=前端调试工具:30 个字符,却占 42 个 UTF-8 字节——6 个汉字各 3 字节,骨架那 24 个字符各 1 字节。只把值交给默认的 encodeURIComponent 一档,输出 78 个字符,即值的 54 个字符加原样保留的骨架;把整条 URL 丢进「全部编码」,结果涨到 90 个字符,因为骨架里的 :、三个 /、? 和 = 都从 1 个字符变成 3 个,粘进地址栏只会被当成搜索词。判断很干脆:骨架自己拼,只编那 6 个汉字;整条 URL 已经成型,就改用 encodeURI 一档。发之前切到解码模式,确认解析面板里只有一对 q,值是恢复后的「前端调试工具」。

常见问题

encodeURIComponent 和 encodeURI 用哪个?
编码参数值用 encodeURIComponent——它会编码 =、&、?、/ 等保留字符,保证参数内容不破坏 URL 结构。编码整个 URL 用 encodeURI,它保留结构字符(: / ? # 等)。最常见的错误是用 encodeURI 编码参数值,导致值里的 & 被当作参数分隔符。
空格应该编码成 %20 还是 +?
取决于语境:在表单编码(application/x-www-form-urlencoded)里是 +;在 RFC 3986 标准的 URL 里必须是 %20,encodeURIComponent 输出的就是 %20。跨系统传参出问题时,"+"与"%20"混用往往就是元凶。
为什么解码后出现 � 替换符?
说明字节序列不是合法 UTF-8:通常是编码与解码用了不同编码(如 GBK 内容按 UTF-8 解码),或 % 序列被二次编码/解码(%2520 → %20 → 空格)。检查整条链路的编码约定,本工具的三种严格编码模式可帮助定位。

内容复核: