URL 参数解析器

🔗 URL Parameter Parser

📐 工作原理与说明
取输入的 URL,以第一个问号为界拆出基础地址与查询串(没有问号时查询串为空)。查询串按与号切分,每段按第一个等号拆为键与值,键与值都先做 URI 解码(解码前把加号替换为空格),得到参数对列表。随后按模板逐行渲染参数行,并支持按开关切换是否编码、以 JSON 形式导入导出、增删参数以及复制拼接后的完整 URL
解析 URL 中的查询参数。
  • 位置:查询串位于 ? 之后,形如 k1=v1&k2=v2,片段标识在 # 之后。
  • 解析:按 & 切分为键值对,再按首个 = 分割,并对键值做百分号解码。
  • 重复键:同名参数可出现多次(如 ?tag=a&tag=b),应解析为数组。
  • 工具:浏览器中可直接用 URLSearchParams 完成解析与序列化。

Parse a URL's query string into keys and values, and edit parameters to rebuild the URL.

📚 深度解析:URL Parameter Parser

💡 常见使用场景

  • 把查询串解析为键值对,便于调试接口。
  • 调试回调接口:把收到的查询串解析成键值对,确认每个参数的值与编码是否正确。
解析
`?page=2&sort=desc&ids=1,2` → {page:2, sort:"desc", ids:"1,2"}。

❓ 常见问题(FAQ)

重复键如何处理?
通常取最后一个或合并为数组,视实现而定。
为什么中文参数显示成百分号?
因为 URL 只能传输 ASCII,非 ASCII 字符会先按 UTF-8 编码再逐字节转成 %XX 形式,这是标准行为而非乱码,解析时按 UTF-8 解码即可。若出现真正的乱码,通常是发送方用了 GBK 而接收方按 UTF-8 解码(或反之),需统一编码约定。

Formula & Standard References

Item Formula / Note Source / Standard
Query syntax starts with ?, key=value joined by & RFC 3986 Section 3.4
Encoding encode keys and values; plus may denote space RFC 3986 / HTML forms
Ordering the spec defines no ordering semantics RFC 3986
⚠️ 使用说明与注意事项