URL 编解码
对 URL 做百分号编码或解码。区分「参数值 / 整条 URL / 双重编码」三种范围,避免链接里的 & 被吃掉,也能拆开看每个参数。
All long-form content on this page is available in English. A few example inputs stay in Chinese because they demonstrate Chinese-language text processing.
URL 编解码是什么
URL 编解码是一款把中文与特殊字符转成百分号编码的工具,提供「参数值 / 整条 URL / 双重编码」3 种范围,避免 & 与 # 被解析成链接语法。URL 里不能直接出现中文、空格和 「&」、「#」、「=」 这些有特殊含义的字符,必须换成百分号编码。这个工具把编码范围做成了显式选项——参数值、整条 URL、双重编码,三者结果差别很大,选错就会出现「链接被截断」「参数值里的 & 变没了」这类问题。
所有计算都在你的浏览器本地完成,输入的内容不会上传到服务器。
怎么用URL 编解码
先选方向(编码或解码),再选范围(参数值或整条 URL),两步选错是最常见的错。整条 URL 保留 ://、/、?、&、= 这些结构字符,只编中文与空格;参数值会把 & 与 = 也编掉,因为它假设这段内容只是一个值。
- 先选方向:编码还是解码。然后选范围——只改一个参数的值用「参数值」,整条链接里有中文用「整条 URL」
- 「整条 URL」保留 「://」、「/」、「?」、「&」、「=」 这些结构字符,只编码中文与空格;「参数值」会把 「&」、「=」 也编掉,因为它假设这段内容只是一个值
- 把一条带参数的 URL 塞进另一个 URL 的 query 里(比如回调地址、跳转链接)时,用「双重编码」——否则内层的 「&」 会被外层当成参数分隔符
- 解码时如果来源是表单或 query string,保留「把 + 当成空格」的勾选;如果 「+」 确实是字面加号,先取消勾选再解
- 展开「拆开看每个参数」可以看到每个键值解码后的真实内容,排查「哪个参数里混了未编码的 &」时比重看整串快得多
示例
输入
https://gjxtools.com/search?q=在线工具箱&lang=zh-CN输出
https://gjxtools.com/search?q=%E5%9C%A8%E7%BA%BF%E5%B7%A5%E5%85%B7%E7%AE%B1&lang=zh-CN用「整条 URL」模式:结构字符保留,只编码中文。
常见问题
为什么中文编码后是一长串 %E4%B8%AD 这样的东西?
一个汉字在 UTF-8 里占 3 个字节,每个字节写成 「%」 加两位十六进制就是 9 个字符。所以「中」变成 「%E4%B8%AD」 是正常的,不是重复编码。
解码报错说百分号序列不完整?
说明输入里有孤立的 「%」,或者 「%」 后面跟的不是两位十六进制(常见于手改链接时删掉了半个字符)。找到那个 「%」 补全或者删掉即可。
参数里的空格到底该用 + 还是 %20?
严格按 RFC 3986,空格应该编成 「%20」;「+」 表示空格是 「application/x-www-form-urlencoded」 这个表单规范的约定。两者在 query string 里通常都能被服务端正确解析,但放进路径段时只有 「%20」 是对的。
小提示
小提示是一种编码状态说明:下面 3 条讲的是编错了为什么整串会废。首先确认编码是幂等的,重复编码会把百分号本身也编掉;其次空格有两种合法写法,位置不同含义不同;另外,编码参数值不要用整串编码函数。
- 编码是幂等的:对已经编码过的串再编一次,「%」 会变成 「%25」,整串就废了。所以先判断当前状态再动手
- 空格有两种合法写法:「%20」 和 「+」。前者在任何位置都有效,后者只在 query string 里有「空格」的含义,用在路径里会被当成字面加号
- 不要用 「encodeURI」 编码参数值。它不编码 「&」、「=」、「+」、「#」,值里带这些字符时会直接把 query 结构搞坏——这正是本工具把两种范围分开的原因