01
1. 为什么要用 URLSearchParams 编码
查询字符串中经常包含中文、空格,以及 `&`、`=`、`#` 等特殊字符。手动拼接这些内容很容易出现编码遗漏、重复编码或分隔符冲突等问题。URLSearchParams 是浏览器标准 API,会按照 application/x-www-form-urlencoded 规则对每个值进行正确的百分号编码,并用 `&` 安全地拼接起来。本工具正是使用这套逻辑生成结果。
🧩 查询字符串生成器
添加键(key)与值(value)行,即可通过 URLSearchParams 立即生成正确进行百分号编码的查询字符串。输入基础 URL 可直接查看完整拼接后的 URL;反之,粘贴现有的查询字符串或 URL,可将各参数拆解为表格展示。
结果
更多开发者工具
了解更多
02
2. 重复键如何处理
像 `category=IT&category=Dev` 这样同一个键出现多次的查询字符串,常见于多选筛选或数组类参数。解析标签页通过 URLSearchParams.entries() 按顺序读取所有条目,即使键相同,也会为每个值单独生成一行显示——避免了只保留第一个值、遗漏其余值的常见错误。
03
3. 在生成与解析之间往返验证
将完整 URL 粘贴到解析标签页时,系统会准确提取 `?` 之后(且 `#` 之前)的部分作为查询字符串。反过来,将生成标签页得到的结果粘贴回解析标签页,即可验证编码是否符合预期、每个值是否能正确还原为原始形式。
常见问题
包含中文或表情符号的值能否被正确编码?
可以。URLSearchParams 基于 UTF-8 将所有非 ASCII 字符转换为标准百分号编码。无论是中文、表情符号还是空格,均能被安全编码。
键或值为空时如何处理?
键为空的行不会包含在结果中。若值为空但键存在,仍会以 `key=` 的形式包含在结果中。
不输入基础 URL 会显示什么结果?
如果没有基础 URL,只会显示类似 `?key=value&...` 的查询字符串本身。输入基础 URL 后,会生成类似 `基础URL?key=value&...` 的完整 URL。
输入的数据会发送到服务器吗?
不会。生成和解析均完全在浏览器 JavaScript 中处理,不会发送到任何服务器。