这个工具用来做什么
网址里只能安全出现一部分 ASCII 字符。空格、中文、井号、问号、与号、等号在地址中各自承担语法含义,如果参数值里直接出现,就会把地址结构弄乱。百分号编码(也叫 URL 编码)解决的就是这个问题:把不能直接出现的字节写成 % 加两位十六进制数字,例如一个空格写成 %20,一个汉字在 UTF-8 下通常写成三个连续的百分号序列。
这个工具提供编码与解码两个方向,并允许你选择三种常见规则。encodeURIComponent 会把几乎所有非字母数字字符都转义,适合处理单个参数值;encodeURI 会保留冒号、斜杠、问号、井号、与号、等号等地址结构字符,适合处理一整条网址;表单编码在 encodeURIComponent 的基础上把空格写成加号,用于传统的表单提交和部分接口参数。
除了转换本身,工具还会把输入里的查询字符串拆成表格。排查接口问题时,编码后的地址往往一长串百分号,肉眼很难确认参数有没有重复、值有没有被转义两次;表格把每个参数的原始写法和解码后的可读值并排放在一起,对照起来快得多。所有处理都在浏览器本地完成,地址和参数不会发送到任何服务器。
怎么用
先把内容粘贴到左侧输入框,再在「编码方式」里选一种规则,最后点「编码」或「解码」。结果会出现在右侧,状态条会告诉你输入与输出各有多少字符,以及处理的模式。
- 处理单个参数值时选 encodeURIComponent,例如搜索词、回调地址、文件名。
- 处理完整网址时选 encodeURI,这样协议分隔符、域名后的斜杠和查询符号不会被一起转义。
- 对接传统表单或要求空格用加号表示的后端时选表单方式;解码时加号会被还原成空格。
- 「清空」同时清除输入与结果;「复制」把结果写入剪贴板,方便直接贴进代码或接口调试工具。
下方的查询参数表不需要点按钮。只要输入内容里出现问号,或者整段内容本身就是 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,否则原始加号会在往返过程中丢失。