用一段合成文本 a+b/c== 做试验,里面的加号就是字面量,不是分隔符,也不把它当成可解码的 Base64。把它直接拼到 q= 后面,再交给 URLSearchParams 读回来:
const value = 'a+b/c==';
const got = new URLSearchParams('q=' + value).get('q');
console.log(got);
在 Node.js v24.22.1 的全局 URLSearchParams 上,got 是 a b/c==。加号变成了空格,斜杠和等号还在。这个变化有固定的解析规则。同样用字符串入口去接 a b,空格还能读回来,加号却会被当成空格。这条入口对两种字符的处理不同。字符串入口一旦把加号读成空格,再调用 toString 会得到 q=a+b%2Fc%3D%3D,原来的加号已经回不去了。
WHATWG URL Standard 里,application/x-www-form-urlencoded 的解析会先把名称和值里的 + 换成空格,再做百分号解码。new URLSearchParams('q=' + value) 走的就是这段查询语法解析,裸加号在这里带着空格的语义。原始值里如果还有 &,还会拆出额外的参数:50% & ? 这样拼进去之后,get('q') 只剩下 "50% ",因为 & 被当成了下一对参数的起点,后面还多出一对名称是 " ?"、值为空字符串的项。不要先把原始值插进一整段查询语法,再丢给构造函数。
可以先建一个空的 URLSearchParams,再用 append() 放入原始值,由序列化处理编码,然后再构造一次,严格比较读回的值:
const value = 'a+b/c==';
const params = new URLSearchParams();
params.append('q', value);
const query = params.toString();
console.log(query);
console.log(new URLSearchParams(query).get('q') === value);
这次 query 是 q=a%2Bb%2Fc%3D%3D,再解析回来的值与原始文本严格相等。append 之后立刻 get('q'),拿到的也还是原值。百分号编码是在 toString() 序列化时发生的。这一页写明:属于 application/x-www-form-urlencoded 百分号编码集合里的字符会按百分号编码,真正的空格(U+0020)可以写成 +。序列化步骤 也是同一套表单规则。这条路径不要求空格一定输出 %20,验收时要比较读回的原始值。这套规则只管表单编码的查询,不要推广到 URL 的所有组件。URLSearchParams 上也写过,URL.search 会把空格写成 %20,和这里的 + 不是同一套输出。
另外几段合成值也走同一条 append 往返,逐个比较读回的结果。a b 序列化成 q=a+b,读回仍是带空格的 a b。50% & ? 得到 q=50%25+%26+%3F,& 被编码成 %26,不再拆出下一对参数。汉字+空 格 得到 q=%E6%B1%89%E5%AD%97%2B%E7%A9%BA+%E6%A0%BC,字面加号是 %2B,中间那个空格是 +。若仍走字符串入口,加号和空格会混成 "汉字 空 格",原来的加号就丢了。
空字符串 append 之后对应 q=,键还在,get('q') 是空字符串。若根本没有这个参数,get('q') 是 null,不要把这两件事混在一起。
字面文本 %2B 序列化成 q=%252B,读回来仍是文本 %2B。若把这三个字符当成已经编码好的查询片段,写成 new URLSearchParams('q=%2B'),读出来才会是 +,因为解析时会把 %2B 解码成加号。文本里本来就写着 %2B 时,不能要求往返结果变成一个加号。
有两种修法会把值改坏。一种是 append 之前先 encodeURIComponent:a+b/c== 会变成 q=a%252Bb%252Fc%253D%253D,再解析得到 a%2Bb%2Fc%3D%3D,已经不等于原值。刚才那份 URLSearchParams 文档还写了,和单个键值打交道时要用未编码的版本。把已经百分号编码的字符串再 append 一次,就会再编码一层。
另一种是读回来以后把空格全局换成加号:a b 会变成 a+b,汉字+空 格 会变成 汉字+空+格,本来就有的空格就被改掉了。加号和空格可能同时出现在同一个值里,读回后再做全局替换,分不清哪一个空格是原来的加号。
以上结果都是在 Node.js v24.22.1 的全局 WHATWG URLSearchParams 上跑的,没有做浏览器兼容性对照,也没有核对后端表单框架的行为。MDN 和 WHATWG 页面都是滚动文档。MDN 页上的兼容性说明不能当成这次已测的版本,也不能当成 API 的最低支持版本。