
把查询参数 q=red blue 序列化后,空格会写作 +,而非 %20。紧接着调用 decodeURIComponent(),加号还在。空格明明已经编码,为什么解码结果没有恢复?
URLSearchParams 为什么把空格写成 +?
它序列化查询参数时使用表单编码规则。空格会写成加号,字面加号则会编码成 %2B。两者在传输文本里是不同的表示,不能把每一个 + 都当成空格。
下面这段用 Node.js 的内置 API 即可运行:
const params = new URLSearchParams();
params.set('q', 'red blue');
console.log(params.toString());
本机运行得到 q=red+blue。相同输入交给 encodeURIComponent('red blue'),结果是 red%20blue。空格字符本身没有变化,变化的是 API 采用的编码规则。URLSearchParams 把参数名和值作为一组来序列化,encodeURIComponent 则对单个 URI 组件做百分号编码。
decodeURIComponent 为什么留下了加号?
decodeURIComponent() 处理 %20 这类百分号转义,不执行表单编码的加号还原。传入字符串 q=red+blue 后,它返回的仍是 q=red+blue。这个结果符合该函数的工作范围,并非解码失败。
容易踩坑的地方,是把「URL 里常见的转义」和「同一种解码规则」画上等号。%2B 经 decodeURIComponent() 会成为字面 +,但没有被百分号转义的 + 就还是加号。它不知道这个字符原本代表空格,也不猜测当前文本是否来自表单编码。
查询串应该交给谁解析?
如果字符串来自 URLSearchParams 的序列化结果,使用相同抽象解析更稳妥:
const encoded = 'q=red+blue';
const value = new URLSearchParams(encoded).get('q');
console.log(value); // red blue
本机输出中,URLSearchParams 解析后得到 red blue,直接调用 decodeURIComponent() 得到的仍是 q=red+blue。前者还负责拆分键值和处理多个参数。后者只负责百分号编码的解码,不是查询参数解析器。
手动先把 + 替换为空格,再调用 decodeURIComponent(),对格式明确的表单式查询串看似可行。但它把输入限定成了特定编码,稍不留神就会把字面加号误处理。比如原值 C++ 被序列化后,其中的加号会成为 %2B;若先对文本做不区分语境的替换,再解码,代码就同时承担了不该由它承担的格式判断。我不建议在业务代码里重复实现这一层,标准解析器已经能区分空格和字面加号。
+ 什么时候才表示空格?
只有按 application/x-www-form-urlencoded 语义解析时,未转义的 + 才按空格处理。作为普通字符串,或者在 URI 的其他位置,+ 本身就是加号。不能拿一个全局替换规则套用到整条 URL,更不能对完整地址随手调用 decodeURIComponent(),否则分隔符、保留字符的含义都可能被改变。
处理真正的 URL 时,可以先用 new URL() 拆出 searchParams,再通过 .get() 读取目标值;只有手头已经是查询参数文本时,才直接把它交给 new URLSearchParams()。不要把完整地址 https://example.test/?q=red+blue 当成查询串直接传入 URLSearchParams,它会把整段内容视为参数文本,键值边界也就不符合预期。先按 URL 结构取出搜索部分,解析职责会清楚很多。
提前解码整段查询串还会影响参数分隔符。比如 q=a%26b 中的 %26 是值里的 &;若先解码,字符串变成 q=a&b,解析器就会把后半段当成另一个参数。本机脚本也跑了这个顺序,最后读到的 q 是 a,原值已经被截断。应先按查询格式解析,再使用字段值,不要把整个查询文本当普通组件解码。
这次脚本验证的是 Node.js v26.8.1 的本机行为,没有覆盖所有浏览器版本或非表单格式的自定义协议,因此这些环境不能仅凭这组输出推断完全一致。把空格交给查询参数序列化器、把查询串交给对应解析器,+ 才会在正确的语境里还原。
runtime: v26.8.1 (darwin)
URLSearchParams: q=red+blue
encodeURIComponent: red%20blue
decodeURIComponent: q=red+blue
URLSearchParams parsed: red blue
literal plus round trip: C++
encoded ampersand round trip: a&b
assertion: PASS (query parser restores spaces and preserves literal plus)