encodeURIComponent 和 encodeURI 到底用哪个?
一句话:转「参数值」用 encodeURIComponent,转「整条 URL」用 encodeURI。encodeURIComponent 会把 &、=、?、# 这些结构符也转成 %XX,保证值里的特殊字符不会破坏 URL 结构;encodeURI 则保留它们,只转中文、空格这类不能直接出现在网址里的字符。拿不准就都试一遍,右边结果贴回浏览器地址栏一看便知。
encodeURIComponent 全编码 / encodeURI 保留结构符,双档切换,%ZZ 非法序列报错不静默。
全编码:& = ? # / 也转成 %XX,适合转「参数值」。
文本只在这台设备的浏览器里转换,不上传、不收集、断网也能用;编码档位选项只存本机 localStorage,换设备、清缓存会丢。想删掉,点页脚的「清空我的数据」。
| 输入格式 | 任意 UTF-8 文本;多行时逐行独立处理(每行结果对应一行);单次 ≤1MB |
|---|---|
| 输出格式 | 百分号编码字符串(%XX 序列,UTF-8 字节);解码方向还原为原文 |
| 关键参数 | 编码档位默认 encodeURIComponent(全编码),可切 encodeURI(保留 & = ? # / 等结构符);?mode=uri 可直达;不解析 + 为空格(按 RFC 3986) |
| 处理方式 | 浏览器本地 JavaScript 计算,不上传、无账号;档位选项存本机 localStorage(首屏不写) |
| 上限 | 单次输入 1MB(超出直接拒绝并提示,不会卡死页面);行数不限 |
| 已知边界 | 不解析 application/x-www-form-urlencoded 的 + 号空格(表单数据请先把 + 替换成 %20);不含 Base64URL 处理(那请用 Base64 工具) |
一句话:转「参数值」用 encodeURIComponent,转「整条 URL」用 encodeURI。encodeURIComponent 会把 &、=、?、# 这些结构符也转成 %XX,保证值里的特殊字符不会破坏 URL 结构;encodeURI 则保留它们,只转中文、空格这类不能直接出现在网址里的字符。拿不准就都试一遍,右边结果贴回浏览器地址栏一看便知。
说明输入里有形如 %ZZ、%G1 这种不是合法十六进制的百分号序列,或者 % 后面缺了两位。很多在线工具会悄悄跳过或原样输出,这里选择报错并指出第一个出错的位置——因为那通常意味着你复制的链接被截断或改坏过,静默糊过去只会把问题带到更难查的地方。把 % 补成 %25 再解码,或删掉残缺片段重试。
URL 编码先把字符串按 UTF-8 拆成字节,一个汉字通常 3 个字节,每个字节再写成 %XX 形式,所以「你」是 %E4%BD%A0。emoji 更长:多数 emoji 是 4 字节,转出来 12 个字符。这不是 bug,是 RFC 3986 的规定动作。
这里没有变。那是一段历史遗留:application/x-www-form-urlencoded 表单提交格式确实把空格编码成 +,解码时再把 + 还原成空格。但纯 URL 编码(RFC 3986)里空格应该写成 %20,+ 就是加号本身。本工具按 RFC 3986 处理,+ 原样保留;如果你的数据来自老式表单提交,先手动把 + 替换成 %20 再来解。
不会。编码解码全部在这台设备的浏览器里完成,页面没有上传接口,断网也能用。只有编码档位这类选项记在本机 localStorage,换设备不跟走,页脚「清空我的数据」一键删掉。
文本工具族: