公告 新用户注册即享 免费 SSL 证书 · 域名批量查询单次支持 40 个 · 香港与内地节点均可自助开通
解决方案 帮助中心 关于我们
代理合作 控制台 登录 免费注册

URL 编解码

对网址与查询参数做百分号编码和还原,支持组件、整条网址与表单三种方式,并把查询字符串拆成可读的参数表。

编解码

编码与解码使用同一套方式;解码时表单方式会把 + 还原为空格。
在左侧输入内容后选择方式,再点「编码」或「解码」。整条网址请用 encodeURI,单个参数值请用 encodeURIComponent。
输入 0 字符
结果 0 字符

      

查询参数解析

0 个参数

输入完整网址或 a=1&b=2 这样的查询字符串,这里会实时拆成「参数 / 解码值 / 原始值」三列。

参数解码值原始值
还没有输入内容。

这个工具用来做什么

网址里只能安全出现一部分 ASCII 字符。空格、中文、井号、问号、与号、等号在地址中各自承担语法含义,如果参数值里直接出现,就会把地址结构弄乱。百分号编码(也叫 URL 编码)解决的就是这个问题:把不能直接出现的字节写成 % 加两位十六进制数字,例如一个空格写成 %20,一个汉字在 UTF-8 下通常写成三个连续的百分号序列。

这个工具提供编码与解码两个方向,并允许你选择三种常见规则。encodeURIComponent 会把几乎所有非字母数字字符都转义,适合处理单个参数值;encodeURI 会保留冒号、斜杠、问号、井号、与号、等号等地址结构字符,适合处理一整条网址;表单编码在 encodeURIComponent 的基础上把空格写成加号,用于传统的表单提交和部分接口参数。

除了转换本身,工具还会把输入里的查询字符串拆成表格。排查接口问题时,编码后的地址往往一长串百分号,肉眼很难确认参数有没有重复、值有没有被转义两次;表格把每个参数的原始写法和解码后的可读值并排放在一起,对照起来快得多。所有处理都在浏览器本地完成,地址和参数不会发送到任何服务器。

怎么用

先把内容粘贴到左侧输入框,再在「编码方式」里选一种规则,最后点「编码」或「解码」。结果会出现在右侧,状态条会告诉你输入与输出各有多少字符,以及处理的模式。

下方的查询参数表不需要点按钮。只要输入内容里出现问号,或者整段内容本身就是 a=1&b=2 这样的形式,表格就会自动更新。输入为空时显示提示行;地址里没有查询字符串时,表格会说明没有可拆分的参数。输入中如果有不完整的百分号序列,表格会指出是第几个百分号、位于第几个字符,并跳过本次解析。

结果怎么解读

编码结果里,%20 代表空格,%2F 代表斜杠,%3F 代表问号,%26 代表与号,%3D 代表等号。一个汉字通常会变成三个百分号序列,例如「中」在 UTF-8 下是三个字节,编码后就是三段 %XX。因此一段中文编码后长度会明显增加,这是字节层面的正常结果,不是重复编码。

解码结果应当恢复成人类可读的原文。如果解出来仍是百分号序列,通常有两种原因:一是原文被编码了两次,需要再解一次;二是所选方式不对,例如整条网址用了 encodeURIComponent 编码,解码时却用了 encodeURI,保留字符没有被还原。可以切换方式再试一次,观察差异。

参数表的三列分别表示:参数名(已解码)、参数值(已解码)、服务器实际收到的原始写法。对照后两列可以快速发现空格究竟写成了 %20 还是 +、中文是否被转义、是否存在重复的同名参数。同名参数在标准里是允许的,后端可能取第一个、最后一个或全部,具体取决于框架。

状态条里的字符数按 Unicode 字符统计,不是字节数,也不等于服务器接收到的长度。判断请求体大小时,应当看编码后的实际字符数,因为百分号编码的结果是纯 ASCII,一个字符就是一个字节。

常见的几种情况

空格到底用 %20 还是加号

两者都表示空格,但适用场景不同。%20 是通用的百分号编码,放在路径、查询值、片段里都安全;加号只在 application/x-www-form-urlencoded 的查询字符串里有特殊含义,放在路径里就是一个普通的加号。拿不准时优先用 %20,兼容性最好。

中文变成一长串百分号

这是 UTF-8 字节被逐个转义的结果。一个常用汉字占三个字节,所以会看到三个连续的 %XX;emoji 通常占四个字节。部分老系统使用 GBK,编码出来的序列与 UTF-8 不同,互相解码就会乱码。遇到这种情况要先确认双方约定的字符集,而不是反复编码。

参数被编码了两次

把已经编码过的地址再整体编码一次,会出现 %25 这样的结果,因为百分号本身也被转义了。判断方法是解码一次后仍然看到大量 %XX。此时再解码一次即可,但更稳妥的做法是回到生成地址的那段代码,确认只对参数值编码,而不是对整条已经拼好的地址再编码。

使用限制与提醒

单次输入上限为 200,000 个字符。超过上限时工具会提示并停止处理,不会截断后继续,避免得到看似成功却不完整的结果。超长内容建议在本地脚本或后端处理。

百分号编码不是加密,也不是签名。它只保证地址结构不被破坏,任何人都能还原。地址会进入浏览器历史、服务器访问日志、代理日志和 Referer 头,把令牌、手机号、身份证号直接放在查询参数里,等于把它们写进多份日志。敏感信息应放在请求体或请求头,并使用加密传输。

编码规则只做字符转换,不校验语义。一个编码后的地址是否真的可访问,取决于域名、路径、参数名和服务端实现,本工具无法判断。若结果在浏览器里打不开,先检查协议、域名和端口,再检查参数名是否拼写正确。

关于加号:解码表单方式时,所有加号都会被当作空格。如果参数值本身需要保留加号,应在编码阶段写成 %2B,否则原始加号会在往返过程中丢失。

下一步:把结果放到线上环境

URL 编解码的结果要落地,还需要一台可用的服务器与运行环境,先确认 CPU、内存与带宽。

推荐产品 云服务器 回调地址对不上时,除了编码还要核对服务器上的重写与代理规则。 查看配置与价格
需要协助 提交工单 部署或联调卡住时,把报错与配置贴进工单,7×24 小时有人跟进。 提交工单