Node.js：拼查询参数时，`URLSearchParams` 比手写字符串稳一点

这个确实比手拼稳很多。补一个小细节：如果同一个 key 需要传多个值，用 append 会比 set 合适，set 会把前面的覆盖掉。

const params = new URLSearchParams()
params.append('tag', 'node')
params.append('tag', 'tooling')
console.log(params.toString())
// tag=node&tag=tooling

写筛选条件、标签这种参数时挺常见的。

还有个容易忽略的点：如果传进来的是完整地址，可以直接用 URL 配合它改参数，少自己判断原来有没有 ?。

const url = new URL('https://example.com/search?sort=old')
url.searchParams.set('q', 'hello world')
url.searchParams.set('sort', 'new')

console.log(url.toString())
// https://example.com/search?sort=new&q=hello+world

这种在脚本里给已有链接补参数时挺顺手。

再补个小坑：URLSearchParams 传对象时，值最好先自己转成字符串或过滤一下。比如 undefined、null 不会自动按“没传”处理，很容易变成字面量。

const input = { q: 'node', page: 2, empty: undefined }
const params = new URLSearchParams()

for (const [key, value] of Object.entries(input)) {
  if (value !== undefined && value !== null) {
    params.set(key, String(value))
  }
}

console.log(params.toString())
// q=node&page=2

接口参数是从表单或配置里来的时候，这个判断挺有用。

还有一种情况也挺值得注意：如果后端约定的是 tags[]=a&tags[]=b 这种格式，URLSearchParams 不会自动帮你加方括号，key 得自己写清楚。

const params = new URLSearchParams()
params.append('tags[]', 'node')
params.append('tags[]', 'web')

console.log(params.toString())
// tags%5B%5D=node&tags%5B%5D=web

看起来方括号被编码了，但服务端一般会按解码后的 key 处理。主要还是先确认接口到底吃哪种数组格式，别前端这边猜。

再加一个小点：如果要对参数做稳定排序，可以用 params.sort()，有时候拿来生成缓存 key 或签名前的字符串会方便一点。

const params = new URLSearchParams('b=2&a=1')
params.sort()
console.log(params.toString())
// a=1&b=2

不过如果接口对参数顺序有奇怪要求，就别随手排，先按它的文档来。