# URLSearchParams 把带加号的值拼进查询串，读回来怎么变成了空格？

**URL:** <https://www.shiqidu.com/t/topic/2138>\
**Category:** 开发调优\
**Tags:** JavaScript, 前端开发, HTTP, 浏览器\
**Created:** [2026 年11 月 22 日 12:15 UTC](https://www.shiqidu.com/t/topic/2138 "2026-11-22T12:15:29Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![shiqidu\_editor](https://www.shiqidu.com/user_avatar/www.shiqidu.com/shiqidu_editor/32/528_2.png) [@shiqidu\_editor](https://www.shiqidu.com/u/shiqidu_editor)\
发布日期： [2026 年11 月 22 日 12:15 UTC](https://www.shiqidu.com/t/topic/2138/1 "2026-11-22T12:15:30Z")

</div>

用一段合成文本 `a+b/c==` 做试验，里面的加号就是字面量，不是分隔符，也不把它当成可解码的 Base64。把它直接拼到 `q=` 后面，再交给 `URLSearchParams` 读回来：

```javascript
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](https://url.spec.whatwg.org/#concept-urlencoded-parser) 里，`application/x-www-form-urlencoded` 的解析会先把名称和值里的 `+` 换成空格，再做百分号解码。`new URLSearchParams('q=' + value)` 走的就是这段查询语法解析，裸加号在这里带着空格的语义。原始值里如果还有 `&`，还会拆出额外的参数：`50% & ?` 这样拼进去之后，`get('q')` 只剩下 `"50% "`，因为 `&` 被当成了下一对参数的起点，后面还多出一对名称是 `" ?"`、值为空字符串的项。不要先把原始值插进一整段查询语法，再丢给构造函数。

可以先建一个空的 `URLSearchParams`，再用 [append()](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams/append) 放入原始值，由序列化处理编码，然后再构造一次，严格比较读回的值：

```javascript
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()](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams/toString) 序列化时发生的。这一页写明：属于 `application/x-www-form-urlencoded` 百分号编码集合里的字符会按百分号编码，真正的空格（U+0020）可以写成 `+`。[序列化步骤](https://url.spec.whatwg.org/#concept-urlencoded-serializer) 也是同一套表单规则。这条路径不要求空格一定输出 `%20`，验收时要比较读回的原始值。这套规则只管表单编码的查询，不要推广到 URL 的所有组件。[URLSearchParams](https://developer.mozilla.org/en-US/docs/Web/API/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 的最低支持版本。
