UB

URL 参数拼接

逐行拼查询参数 + 自动编码 + 反向解析回填

keyvalue
—

                
查询串里的空格编码成 %20,只有在 application/x-www-form-urlencoded 表单提交里才用 + 表示空格。路径段里的 / 不能被编码,所以拼路径不要用这个工具,它只处理 ? 后面的部分。

如何使用本工具

  1. 在「基础地址」里填要拼接的 URL,路径和主机照抄即可,自带的老查询串会被忽略。
  2. 逐行填 key 和 value,左边的勾选框可以临时关掉某一行而不删掉它,右侧 × 直接删除。
  3. 按需勾选「按 key 排序」「跳过空值」「保留 #片段」「严格编码」,右侧结果实时刷新。
  4. 已经有现成 URL 时,把它贴进基础地址再点「从 URL 解析」,参数会自动拆成一行行回填。
  5. 结果区下方直接给出 curl 和 fetch 两种调用写法,复制就能用。

常见问题

Q:空格到底该编码成 %20 还是 +?

A:查询串里用 %20 最稳妥。+ 只在 application/x-www-form-urlencoded 表单提交里代表空格,而 URLSearchParams 在解析时也会把 + 当空格。如果参数值本身要包含加号,必须写成 %2B,否则会被服务端还原成空格。

Q:encodeURIComponent 和 encodeURI 有什么区别?

A:encodeURI 保留 : / ? # & = + $ , 这些结构字符,适合编码整条 URL;encodeURIComponent 把这些全部编码,适合编码单个参数值。拼参数时必须用 encodeURIComponent,用 encodeURI 会让参数值里的 & 和 = 变成新的分隔符,直接破坏查询串。

Q:为什么 encodeURIComponent 没编码 ! ' ( ) * ?

A:这是规范里明确列出的不转义字符(unreserved marks),它们不会破坏 URL 结构。但部分老服务端或 WAF 会对这些字符做额外校验,所以本工具提供了「严格编码」开关,勾上后会把它们补成 %21 %27 %28 %29 %2A。

Q:同名参数重复出现会怎样?

A:会按行顺序原样保留,例如 tag=前端&tag=工具。这是查询串里表达数组的常见写法,服务端一般解析成列表。不要自己拼成 tag[]=前端,方括号需要额外编码成 %5B%5D,不同框架对它的兼容性并不一致。

Q:URL 长度有上限吗?

A:没有统一标准。HTTP 规范没规定,但实际限制来自浏览器(Chrome 约 2MB)、反向代理(Nginx 默认 8KB 请求行)、CDN 和应用服务器(Tomcat 默认 8KB)。本工具在超过 2000 字符时会提示,这个数值是兼容性较好的经验阈值,长参数建议改用 POST 请求体。

Q:相对路径和绝对地址都能拼吗?

A:都能。工具只做字符串拼接,不解析主机,所以 /api/list 这种相对路径一样可以拼出 /api/list?q=x。如果你需要基于当前页面计算绝对地址,得用浏览器里的 new URL(path, location.href) 来补全。