toolgarden.xyz
EN

URL / Query String 构造器

拆解或构造 URL 的 query string,支持新增、编辑、自动编码参数并实时预览结果,浏览器本地处理。

URL

URL

参数

构造结果

https://example.com/api/users?page=1&sort=asc#section

工具说明

URL 由协议、主机、端口、路径、查询参数和片段等部分组成。手工拼接时,斜杠、问号、等号与百分号编码很容易出错,尤其是参数值本身包含空格、中文、`&` 或另一个 URL 的情况。

URL 构建器把各组成部分分开编辑,再生成结构明确的地址。它适合准备接口请求、营销链接和回调地址,也能帮助区分查询参数与页面片段,减少重复编码或遗漏编码。

使用步骤

  1. 填写基础地址

    输入协议与主机,并按需要补充端口和路径。

  2. 添加查询参数

    逐项填写参数名和值,让工具处理分隔符和必要的 URL 编码。

  3. 检查并复制

    核对最终路径、参数顺序和片段,复制后在目标环境发起一次真实请求。

输入与输出示例

注意值里的空格和中文被 percent-encode,而分隔符 & = 保持原样。

参数
q      = 张三 test
page   = 2
tags   = a
tags   = b
构造出的 URL
?q=%E5%BC%A0%E4%B8%89%20test&page=2&tags=a&tags=b

支持范围与限制

两个方向
拆解现有 URL 的 query string,或逐个添加参数构造新 URL
自动编码
参数值中的空格、中文、&、= 等字符会按 percent-encoding 转义
重复参数
同名参数可以出现多次(如 tag=a&tag=b),拆解时会按出现顺序全部列出
空值处理
区分「参数存在但值为空」(key=)和「参数不存在」两种情况
fragment
# 之后的片段标识不属于 query string,不会被发送到服务器
隐私提醒
URL 会出现在日志、Referer 头和浏览器历史里,不要把敏感信息放进 query 参数

典型使用场景

  • 构造 API 请求

    组合分页、筛选和排序参数,避免在代码之外手工处理多个 `&`。

  • 生成可追踪链接

    为活动页面加入来源参数,同时保留已有查询项和页面锚点。

  • 拆解出问题的回调地址

    第三方回调或重定向地址报错时,拆开逐个参数检查编码是否正确、必填参数是否齐全。

使用前需要知道的事

  • 参数名和值应分别编码,不要先把整条 URL 编码后再作为地址使用。
  • 片段位于 `#` 后,通常不会随 HTTP 请求发送到服务器。
  • 不要把口令、令牌或敏感个人数据放入查询字符串,它们可能出现在历史记录和服务器日志中。

相关概念

query string
位于 `?` 之后的一组键值参数,多项通常用 `&` 分隔。
percent-encoding
用百分号和十六进制字节安全表示 URL 中的保留字符或非 ASCII 文本。

常见问题

URL 构造器能做什么?
可以拆解一个 URL 的查询参数,逐项添加、编辑、删除,并实时预览拼接后的完整 URL。
会自动处理编码吗?
会。参数值中的特殊字符会按需进行 URL 编码,避免手写编码出错。
处理会上传数据吗?
不会。URL 的拆解和构造都在浏览器本地完成,内容不会上传到服务器。
参数值里的 & 为什么必须编码?
因为 & 是参数之间的分隔符。值里出现未编码的 & 会被解析成新参数的开始,把一个值切成两半。所有保留字符(& = ? # +)出现在值里时都必须 percent-encode。
同名参数出现多次合法吗?
URL 规范允许,但服务端的处理方式不统一:有的取第一个,有的取最后一个,有的收成数组。依赖这种写法之前请确认接收方的实际行为。