URL 解析器

简介

URL 解析器将链接拆解为协议、主机名、端口、路径、查询参数和哈希等组件，并自动格式化为易读的结构。支持缺失协议的自动补全、查询参数 JSON 化和哈希参数解析，适用于开发调试、链接校验和数据清洗场景。

核心功能

• 完整组件解析:拆解协议、用户名、密码、主机名、端口、路径、查询和哈希
• 自动协议补全:输入纯域名时自动尝试添加 https://
• 查询参数 JSON 化:将 URL 参数转换为可读的 JSON 格式
• 哈希参数支持:解析哈希片段中的 key=value 参数
• 快捷复制:一键复制任意组件或参数 JSON

使用方法

输入 URL

1. 在输入框粘贴完整 URL 或域名
2. 缺少协议时工具会自动尝试补全为 https://
3. 有效链接会立即展示解析结果，无效链接显示错误提示

查看解析结果

解析结果分为以下部分：

URL 组件

• 协议(Protocol) 的协议部分，如 https://
• 主机名(Hostname):域名或 IP 地址
• 用户名(Username):如 URL 中包含认证信息
• 密码(Password):如 URL 中包含认证信息
• 端口(Port):端口号，如未指定则为空
• 路径(Pathname):路径部分，如 /t/url-parser
• 查询(Search):查询字符串，如 $1key=value
• 哈希(Hash):哈希片段，如 #section

每个组件都可以通过点击复制按钮快速复制。

查询参数 JSON

如果 URL 包含查询参数，会以 JSON 格式展示：

• 单值参数显示为字符串
• 重复参数显示为数组
• 示例：{"key1":"value","key2": ["value1","value2"] }

哈希参数 JSON

如果哈希片段包含 key=value 格式的参数，会单独解析并展示为 JSON:

• 仅在哈希中包含 = 时解析
• 格式与查询参数相同
• 常见于单页应用(SPA)的路由参数

应用场景

开发调试

• 快速检查 API 回调 URL 的参数是否正确
• 调试 OAuth 回调地址中的 token 和 state 参数
• 验证深度链接(Deep Link)的路径和参数
• 分析前端路由中的哈希参数

链接校验

• 清洗用户提交的链接，统一协议和格式
• 检查 Webhook、回调地址的协议、端口是否正确
• 验证配置文件中的 URL 字段完整性
• 识别链接中的认证信息或敏感参数

数据清洗

• 批量提取 URL 列表中的域名或路径
• 统一不同来源链接的格式（如统一协议为 HTTPS)
• 分析日志文件中的请求参数分布
• 从 CSV 导出或 API 响应中解析 URL 字段

QA 测试

• 验证跳转链接是否包含必需的追踪参数
• 检查 UTM 参数是否正确拼接
• 确认不同平台分享链接的参数一致性
• 测试深度链接在各操作系统上的解析正确性

解析示例

示例 1：完整 URL

输入：

https://me:[email protected]:5436/t/url-parser$3key1=value&key2=value2#the-hash

解析结果：

• 协议：https://
• 用户名：me
• 密码：pwd
• 主机名：z.tools
• 端口：5436
• 路径：/t/url-parser
• 查询：$4key1=value&key2=value2
• 哈希：#the-hash

查询参数 JSON:

{
  "key1": "value",
  "key2": "value2"
}

示例 2：自动补全协议

输入：

example.com/path$6q=nuxt&lang=en

自动规范为：

https://example.com/path$8q=nuxt&lang=en

示例 3：哈希参数解析

输入：

https://app.example.com/callback#token=abc&expires=3600

哈希参数 JSON:

{
  "token": "abc",
  "expires": "3600"
}

示例 4：重复参数

输入：

https://api.example.com/search$10tag=js&tag=vue&tag=nuxt

查询参数 JSON:

{
  "tag": ["js", "vue", "nuxt"]
}

使用技巧

快速复制

• 点击任意组件右侧的复制按钮可立即复制该部分内容
• 查询参数和哈希参数的 JSON 块也可一键复制
• 复制后按钮会显示「已复制」状态反馈

批量处理

• 对于需要处理多个 URL 的场景，可结合 Excel 或脚本工具
• 将解析结果复制为 JSON 后可直接用于数据分析
• 建议先用单个 URL 测试，确认格式后再批量处理

协议补全规则

• 输入纯域名（如 example.com) 时自动添加 https://
• 已包含协议的 URL 不会修改
• 如需使用 http://,请手动输入完整 URL

技术特点

标准化解析

• 基于浏览器原生 URL API, 确保解析结果准确
• 符合 RFC 3986 和 WHATWG URL 标准
• 正确处理各类特殊字符和 URL 编码

智能参数识别

• 自动区分查询参数和哈希参数
• 正确处理重复参数，合并为数组
• 支持空值参数和特殊字符转义

常见问题

为什么输入后 URL 自动变化

工具会尝试自动补全缺失的协议（添加 https://),使 URL 规范化。如不需要此功能，请输入完整的 URL 包含协议部分。

哈希部分没有解析为参数

哈希参数解析仅在哈希中包含 = 字符时触发。如果哈希仅为锚点（如 #section),则不会进行参数解析，会原样显示。

如何处理包含特殊字符的 URL

工具会自动处理 URL 编码字符（如 %20 代表空格）,解析结果会显示解码后的值。如需保留原始编码，请在复制后自行处理。

特点

1. 基于标准 URL API 更准确可靠
2. 提供更友好的界面和快捷复制功能
3. 无需安装且支持可视化展示，适合快速校验和调试

注意事项

• 解析仅在客户端进行，不会向服务器发送 URL 内容
• 包含敏感信息（密码、token) 的 URL 请谨慎使用
• 工具仅解析 URL 结构，不验证链接的可访问性或有效性
• 对于包含中文或其他非 ASCII 字符的 URL, 建议先进行 URL 编码