工具说明
URL 由协议、主机、端口、路径、查询参数和片段等部分组成。手工拼接时,斜杠、问号、等号与百分号编码很容易出错,尤其是参数值本身包含空格、中文、`&` 或另一个 URL 的情况。
URL 构建器把各组成部分分开编辑,再生成结构明确的地址。它适合准备接口请求、营销链接和回调地址,也能帮助区分查询参数与页面片段,减少重复编码或遗漏编码。
使用步骤
填写基础地址
输入协议与主机,并按需要补充端口和路径。
添加查询参数
逐项填写参数名和值,让工具处理分隔符和必要的 URL 编码。
检查并复制
核对最终路径、参数顺序和片段,复制后在目标环境发起一次真实请求。
输入与输出示例
注意值里的空格和中文被 percent-encode,而分隔符 & = 保持原样。
q = 张三 test
page = 2
tags = a
tags = b?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 文本。