跳到主要内容
AZ Tools

URL Query 构建器

干净的表单,逐个添加、编辑、禁用查询参数,结果 URL 实时构建。键值经过 `encodeURIComponent`;你可以选择空格保留为 `%20` 还是折叠为 `+`(form-urlencoded 变体)。禁用行留在列表但不出现在输出 — 方便保存备选而不丢失。

参数 (3)
空格作为:
构建的 URL
https://api.example.com/search?q=cloudflare%20workers&page=1&sort=relevance

键值通过 encodeURIComponent percent 编码 — 任何规范客户端都用的规则。

使用方法

  1. 输入基础 URL。如果已带 `?`,构建器会用 `&` 追加其余。
  2. 添加 key-value 行。切换勾选框以包含 / 排除该行而不删除。
  3. 根据服务器期望(标准 URI 编码或 form-encoded)选择 `%20` 或 `+`。

常见问题

何时空格用 `+`?
当服务器把查询字符串当 `application/x-www-form-urlencoded` 处理时 — 大多数老式表单处理器和 CGI 脚本如此。现代 REST API 通常两种都接受;`application/json` POST 体的安全默认是 `%20`。
允许重复键吗?
允许 — 多数服务器把重复键当数组处理。少数只保留最后一个;不确定请查 API 文档。
值里面哪些字符必须编码?
凡是会被当作结构读取的字符:与号、等号、空格,尤其是井号。井号之后的部分属于片段,根本不会发送给服务器,所以一个没编码的井号,就会悄悄把值剩下的部分从请求里截断。斜杠和冒号在查询字符串里是合法的,可以原样保留,当然编码了也无妨。
参数的顺序重要吗?
对服务器不重要,它可以按任意顺序读取。但在其他地方都重要:缓存和 CDN 用完整的 URL 文本作为键,同样的参数换个顺序就是另一条缓存记录;而任何对 URL 做签名或比较的东西——统计分析、签名链接、去重——看到的都是两个不同的字符串。即使没人强制,也请保持顺序稳定。

相关工具