网络工具

URL 解析

解析 URL 的各个组成部分,支持参数编辑

🔗

输入 URL 开始解析

什么是 URL?

URL(Uniform Resource Locator,统一资源定位符)是互联网上资源的地址。它指定了资源的位置和访问方式。一个完整的 URL 由多个部分组成。

URL 组成部分

  • protocol(协议):如 http:、https:、ftp:,定义通信方式
  • username/password:可选的身份验证信息
  • hostname(主机名):域名或 IP 地址
  • port(端口):服务监听的端口号
  • pathname(路径):资源在服务器上的路径
  • search(查询字符串):以 ? 开头的参数列表
  • hash(锚点):以 # 开头的页面内定位

本工具功能

  • 解析 URL 的各个组成部分
  • 可视化 URL 结构(颜色标注)
  • 查询参数的查看、编辑和删除
  • 添加新的查询参数
  • 一键复制各部分内容

使用场景

  • 调试 API 请求 URL
  • 分析跟踪链接参数
  • 构建和修改 URL
  • 学习 URL 结构规范

用浏览器的 WHATWG URL 解析器拆解一条绝对 URL,分项给出协议、userinfo、host 与 hostname、端口、路径、查询串和锚点,并把查询参数还原成可编辑的键值表。适合排查回调与跳转链接、跟踪参数,以及那些被编码字符掩盖了真实取值的接口地址。

真正干活的是哪个解析器

输入直接交给构造器 new URL(),实现的是 URL Living Standard,而不是旧的 url.parse,也不是自己写正则去抠 RFC 3986 的那些分隔符。因此归一化在展示之前就已发生:协议与主机名统一转小写,HTTPS://Shop.Example.COM 报告成 https: 与 shop.example.com;端口等于协议默认值(http 与 ws 为 80、https 与 wss 为 443、ftp 为 21)时被整个抹掉,port 为空且 href 里连冒号都不剩;. 与 .. 段按路径规则消解,空路径补成 /,特殊协议里反斜杠等同正斜杠。国际化域名返回以 xn-- 开头的 punycode 标签,而路径和查询串里原有的百分号三元组原样保留,小写十六进制也不会被改写。

host、hostname、port、origin 是四个不同的串

hostname 只有主机名;host 仅在端口非默认时才补上 :端口,所以多数线上 URL 上两者一模一样,只比对 host 的代码碰到 https://example.com:8443/ 就会静默失配。origin 是协议加 host,去掉 userinfo、路径、查询串和锚点,浏览器判断 CORS 与存储分区比的正是它;对 foo://example.com/x、data:text/plain,hi 这类非特殊协议,origin 是字面量 null,永远匹配不上任何白名单。userinfo 按存储形态返回、仍是百分号编码(空格是 %20、@ 是 %40),需要单独解码;RFC 9110 已不推荐在 URL 里携带凭据,浏览器和代理也往往直接剥掉。

语法正确的 URL 为什么也会报错

参数列表来自 URLSearchParams,它已经解过一次码并把 + 还原成空格;组件又对结果调用 decodeURIComponent 去填「已解码」那一行,等于解了两次。只要解出来的值里含孤立的百分号,第二步立刻抛 URIError: URI malformed,而 ?discount=100%25 正是如此:解析得到 100%,再解即失败,外层 catch 报出与「无法解析」一字不差的提示。链接本身没问题,坏的是这一行的二次解码。真正的二次编码反而能正常显示:?q=a%2520b 的取值是 a%20b,解码行给出 a b。

实操示例

一条带凭据、默认端口与 .. 段的跳转链接

输入
HTTPS://User:pa%40ss@Shop.Example.COM:443/a/../b?q=%E4%B8%AD+ok&ref=#top
输出
href: https://User:pa%40ss@shop.example.com/b?q=%E4%B8%AD+ok&ref=#top
protocol: https:
username: User
password: pa%40ss
host: shop.example.com
hostname: shop.example.com
port: (该行不显示)
pathname: /b
search: ?q=%E4%B8%AD+ok&ref=
hash: #top
origin: https://shop.example.com
q = 中 ok
ref = (空串)

:443 等于 https 默认端口,因此端口行被隐藏,origin 既不带端口也不带 userinfo;换成 8443 就会保留。/a/../b 消解为 /b,主机名转小写。参数 q 显示为 中 ok,因为 %E4%B8%AD 还原成汉字、+ 还原成空格;而密码保持 pa%40ss,其中的 %40 代表 @。

边界与常见误用

  • 构造器不接收 base,相对引用(example.com/a、/a?b=1)一律抛错,提示与「URL 非法」相同;补上协议前缀才解析得动。
  • 参数行以键名作为 key,同名参数出现两次就会在列表里撞车;searchParams.set 只留一对,删除则清掉全部同名项。需要逐条编辑重复参数,请改用 tag[]、tag.1 这类不同的键名。
  • 任何一次编辑都经 URL.toString() 写回输入框,改动会超出你的操作本身:裸主机被补上结尾 /,空的 ? 与 # 被丢弃,已有的百分号三元组保持粘贴时的写法而非重新编码,前后对比会看到这些附带改写。
  • 值里真的含百分号就显示不全:?discount=100%25 虽然能解析,但多余的解码步骤失败,工具直接报 URL 非法;要观察字面 % 请换一个样例。
  • 锚点会被解析并显示,却永远不会发给服务器;userinfo 在界面上保持百分号编码。两者都不足以推断 HTTP 请求里真正发出的内容。

相关工具

出问题时先看这里

一边打字一边冒红字说 URL 非法,打完最后一个字符才消失

原因输入框是监听式的,不是提交式的:watch(urlInput) 每次变化就跑一遍 new URL(),h、http:/、光秃秃的 https:// 全部抛异常,而抛出的异常被映射成与「链接格式错误」完全相同的那句提示。

处理整条链接一次粘贴进来。手打的话,红字只反映「还没输完」——协议加主机名齐了就不再报,https://e 已经能解析——地址没输全之前不必去查原因。

URL 还没粘,先点了「添加」,结果冒出一条 example.com 的链接,参数挂在后面

原因addParam 在输入框为空时兜底用 new URL("https://example.com") 建对象再 append。添加按钮只在键名为空时禁用,从不检查 URL 框。

处理先把目标 URL 粘进来再加参数。已经生成了假链接就点「清空」重来,别点那一行的 ✕:删掉参数只会剩下 https://example.com/,而它是能被正常解析的。

界面上一行都不缺,复制出来的报告里 hostname、端口、锚点却没了

原因copyResult 只在字段非空时才写该行,hostname 与 host 相等时整行跳过;参数也只按解码后的值输出,不带「已解码」那一行。而下方的卡片对 hostname、origin 是无条件渲染的,两个视图本来就不一致。

处理要精确字符串就用每个字段自己的复制按钮,hostname、port、origin 直接看卡片。复制出来的是摘要,不是面板的镜像。

我在值里打了空格和一个 +,链接里同时出现 + 和 %2B

原因所有编辑都由 URLSearchParams 按 application/x-www-form-urlencoded 规则序列化:空格出成 +,手打的 + 出成 %2B,&、= 出成 %26、%3D,非 ASCII 字符出成 %E4%B8%AD 这类 UTF-8 三元组。值输入框里显示的始终是解码后的文本,所以框里和链接里不可能逐字符对齐。

处理按「服务端该收到什么」来填,填完看 search 字段确认线上形态。若接收端按原始 URI 解码而不是表单解码,空格必须是 %20——这一点在本页没法强制,去 URL 编解码工具生成好这一对再粘回来。

IPv6 链接的 hostname 一行带着方括号,显示成 [::1]

原因WHATWG 序列化把方括号算进主机字段:http://[::1]:8080/x 拆出来是 hostname = [::1]、host = [::1]:8080。方括号是 URL 的语法,不是地址的一部分,展示前没有任何去壳处理。

处理把字符串交给 ping、套接字库或 IP 查询页之前,先去掉首尾的 [ 与 ];重新拼 URL 时必须留着,否则地址内部的冒号会被当成端口分隔符。

手工改一条链接,跟另外六种做法怎么分工

你手上的活这个 URL 解析工具什么时候该换
改一个查询参数的值,还要拿回一条能直接用的链接参数表是可写的:改值走 searchParams.set,点 ✕ 走 searchParams.delete,结果经 URL.toString() 写回输入框,于是输入框本身就是新链接,复制走即可。写五行 Node 脚本:new URL(process.argv[1]) 建对象,u.searchParams.set() 改值,console.log(u.href) 输出,用 node rewrite.mjs "$URL" 跑。同一次改动要在每次构建、每行日志上重复时用脚本;需要人判断「新值该填什么」时留在本页。
手里只有相对引用:/a?b=1 或省了协议的 example.com/a构造器只接一个参数、不带 base,这两种写法都抛错,报出的提示跟「链接本身有问题」一字不差。工具既不去推断,也不替你补协议。自己把 base 传进去:控制台里 new URL("/a?b=1", "https://example.com"),或者直接用框架自带的路由匹配器。基址确定无疑时才这么做;在本页手打一个 https:// 前缀,换来的是一个看着合理、origin 却由你编出来的结果。
日志字段或请求体里的一整串百分号编码要还原成可读文本解码只发生在查询参数上,一对一对地来。取值在 URLSearchParams 迭代时已经是解码后的形态,组件再调一次 decodeURIComponent 只是为了填「已解码」那一行,而这一行仅在它与取值不同时才出现。路径段、请求体正文根本不解码。用 URL 编解码工具的解码模式,整串还原、模式可选。凡不是一条完整绝对 URL 的字符串都交给它;本页留给「需要把一条 URL 拆成零件」的场合。
国际化域名要 Unicode 形态,或者反过来要 xn-- 那串 punycode主机在解析时就已经被换掉了:مثال.إختبار 拿回来是 xn--mgbh0fb.xn--kgbechtv,每个标签单独加 xn-- 前缀。只有这一个方向,页面里没有任何回程开关,想看原字符只能另找地方。Punycode 编解码工具按标签双向互转。「这个域名在另一种形态下长什么样」用它;「这条 URL 里装了什么」留在这里。
访问日志里两百条 URL 都要做同一套拆分一次只处理一条,逐键解析,没有批量输入框,也不留历史记录。它的用途是在一条样本上把拆分规则确认清楚,然后把规则交给脚本。交给 shell 循环:awk "{print $7}" access.log | xargs -n1 node -e "console.log(new URL(process.argv[1]).origin)"。先在这里拿一条把规则对清楚,剩下 199 条让循环跑。
两条链接要逐项比对:一次跳转前后,或两组 A/B 变体一次只装一条,粘第二条就把第一条顶掉。两个面板不能并排驻留,差异只能靠来回切、靠记忆核对,参数一多就容易看漏。用同一个 Node 单行命令把两条都规范化、每个组件各打一行,再把两块文本丢给文本对比工具。字符级 diff 能把差异落到具体字符上(「这两条只差 sort」),而本页一次只留一条,切来切去看不出这种细节。

常见问题

URL 的组成部分有哪些?
完整结构是 scheme://userinfo@host:port/path?query#hash。最容易混淆的几点:query 从 ? 开始到 # 之前;fragment(# 后)不会发送到服务器;端口省略时使用协议默认值(http 80 / https 443)。本工具逐项拆解并把查询参数解析成键值表。
为什么参数值取出来多了或少了字符?
几乎都是编码问题:值本身含 & 或 = 却没编码,被截断成多个参数;或被编码两次(%2520)。正确做法是构造时对每个值单独 encodeURIComponent、解析时对每个值单独 decodeURIComponent,而不是对整个 URL 一次性处理。
hash(# 后面的部分)服务端能拿到吗?
不能。fragment 只存在于浏览器端,不会随请求发送给服务器。单页应用的路由(#/page/1)完全在前端处理;如果服务端日志里看不到某些"页面",先检查它们是否只有 hash 路由。

内容复核: