URL 查询字符串构建器

根据键值对构建带查询参数的 URL,可选表单编码(空格为 +)或 RFC 3986(%20)。也可以从现有 URL 导入参数。

参数
生成的 URL
https://example.com/search?q=coffee+%26+tea&page=2
从现有 URL 导入参数

什么是 URL 查询构建器?

查询构建器可以把基础 URL 和一组键值对转换为编码正确的 URL。你可以选择 HTML 表单编码(空格为 +,与 URLSearchParams 相同)或严格的 RFC 3986 百分号编码(空格为 %20),还可以导入现有 URL 的参数进行编辑。

如何使用 URL 查询构建器

  1. 输入基础 URL,例如 https://example.com/search。
  2. 填写键和值的各行;用“添加参数”增加更多行,用 × 删除某一行。
  3. 选择编码方式。
  4. 复制生成的 URL。要编辑现有链接,请展开“从现有 URL 导入参数”。

示例

输入
https://example.com/search, q = coffee & tea, page = 2
输出
https://example.com/search?q=coffee+%26+tea&page=2

使用 RFC 3986 编码时:https://example.com/search?q=coffee%20%26%20tea&page=2

何时使用 URL 查询构建器

适合构造 API 调用、跟踪链接或测试 URL,而不必手工编码 &、= 或空格等特殊字符。如果只想读取现有 URL 的参数,用 URL 解析器会更快。

URL 查询构建器 的工作原理

键为空的行会被跳过,值只会被编码一次。表单编码使用 URLSearchParams.toString();RFC 3986 模式使用 encodeURIComponent,并额外转义 ! ' ( ) *。基础 URL 中已有的查询字符串会被替换,其 #片段保留在末尾。导入功能会在 ? 和 # 处拆分 URL,并用 URLSearchParams 解码这些键值对。

常见用例

  • 构建一个值中含有 & 或 = 的搜索 URL。
  • 创建带 UTM 标记的推广链接。
  • 为 API 测试准备编码后的 GET 请求。
  • 修改长 URL 中的某一个参数,而不破坏其余部分。

常见问题

空格应该用 + 还是 %20?

大多数服务器在查询字符串中都能理解两者。+ 来自 HTML 表单编码;%20 是通用的 URI 编码,当接收方不是典型的 Web 框架时更安全。

可以重复使用同一个键吗?

可以。添加多行相同的键,例如 tag=a 和 tag=b;它们会按顺序保留。

支持非 ASCII 字符吗?

支持,它们会被编码为 UTF-8 百分号转义,例如 ế 会变成 %E1%BA%BF。

推荐的下一步

探索更多分类