Query 参数 ⇄ JSON
GET 参数解析 · JSON 构造 URL
Query 参数
就绪
ABOUT
关于 Query 参数 ⇄ JSON
将 ?a=1&b=2 形式的查询字符串解析为 JSON，或从 JSON 生成 URL 参数。
GET 请求的 query 是接口调试的高频入口：UTM 参数、分页、过滤、OAuth callback——结构看似简单，嵌套与重复键却常让人手工拼接出错。
DEEP DIVE
深入了解 Query 参数 ⇄ JSON
URL 查询字符串（Query String）是 GET 请求传递参数的标准方式。手动解析 ?a=1&b=2&c=hello 既繁琐又容易出错，尤其遇到 URL 编码的中文或嵌套参数时。JSONSort Query 工具双向转换：字符串 → JSON 对象，或 JSON → 查询串。
适合 REST API 调试、构造测试 URL、分析前端 router query 参数、排查 encodeURIComponent 编码问题等日常场景。
application/x-www-form-urlencoded 与 multipart 在数组表示上存在惯例差异。JSONSort 将重复键解析为数组，生成 query 时对数组使用重复键形式——与多数 Java Spring / Node Express 默认行为一致。
FEATURES
核心能力
Query → JSON
解析 URL 查询串为嵌套 JSON 对象，自动 URL 解码。
JSON → Query
从 JSON 对象生成标准 URL 编码的查询字符串。
重复键处理
同名参数转为数组，符合常见服务端解析语义。
编码/解码
自动处理 %XX 形式的中文与特殊字符。
即时输出
粘贴完整 URL 或纯 query 部分均可解析。
本地处理
URL 中可能含 token 等敏感参数，本地解析更安全。
完整 URL 解析
粘贴带域名的完整 URL 自动提取 ? 后 query 部分。
嵌套对象
支持 bracket/dot notation 与 JSON 对象的双向映射。
HOW TO USE
使用步骤
-
1
粘贴 URL 查询串或 JSON 对象
-
2
选择解析或生成方向
-
3
复制结果
-
4
转换失败时查看错误提示，修正源文件语法后重试
-
5
结果可用格式化工具美化，或导出供下游脚本使用
WORKFLOW
典型工作流
从导入数据到导出结果的完整流程，帮助团队统一 Query 参数 ⇄ JSON 的使用方式。
输入 query 或 URL
从浏览器地址栏、Network 面板或日志复制。
查看 JSON
确认嵌套与数组结构符合服务端解析逻辑。
编辑 JSON
修改参数值后反向生成 query 字符串。
发起测试
拼接到 base URL 在浏览器或 Postman 中验证。
USE CASES
适用场景
前端开发
解析 Vue Router / Next.js 的 query 参数为 JSON 调试。
后端开发
构造 GET 接口测试 URL，JSON 定义参数后一键生成 query。
测试工程师
批量构造带多参数的测试 URL。
SEO / 运营
分析落地页 UTM 参数结构，转为 JSON 统计用。
安全测试
拆解 redirect_uri 与 state 参数分析 OAuth 流程。
数据分析
批量 UTM 参数转 JSON 导入 BI 工具做渠道归因。
TIPS
使用技巧
- 粘贴完整 URL 时，工具会提取 ? 后的 query 部分解析。
- JSON → Query 生成的字符串可直接拼接到 base URL 后测试。
- 中文参数会自动 encodeURIComponent，无需手动编码。
- 数组参数在 query 中通常表现为重复键名，解析后还原为数组。
- 与「编解码」工具配合，排查双重编码或编码缺失问题。
- OAuth redirect_uri 的 query 部分可用此工具快速拆解分析。
- + 在 query 中常表示空格，解码时注意与 %20 等价。
- 生成 query 后拼接到 base URL 前检查是否已有 ?。
- 数组参数测试边界：空数组、单元素、多元素三种情况。
- 与 Postman 工具配合：从 Collection 提取 URL 再拆解 query。
LOCAL VS ONLINE
本地 vs 在线工具
JSONSort 坚持纯前端架构，以下对比说明为何本地化工具更适合处理开发数据。
TROUBLESHOOTING
常见误区与排查
实际使用中容易遇到的问题及建议处理方式，减少反复试错的时间。
中文乱码
建议：确认已 URL 解码；双重编码时用编解码工具去一层。
数组变字符串
建议：检查是否应使用重复键而非 JSON 数组字符串。
空值丢失
建议：key= 形式保留为空字符串，与缺失 key 不同。
嵌套深度限制
建议：过深 bracket 可能不被服务端支持，与后端约定格式。
FAQ
常见问题
支持 hash 路由的参数吗？
仅解析 ? 后的 query 部分。# 后的 hash 需手动分离。
空值参数会保留吗？
key= 形式的空值会解析为空字符串 ""。
嵌套对象怎么转 query？
扁平化为 key[nested]=value 或 dot notation，取决于模式。
hash 里的参数能解析吗？
#/page?x=1 中 hash 内 query 需手动分离，标准 ? 前 query 自动处理。
参数顺序会保留吗？
JSON 对象键序可能与原始 query 不同，功能等价。
数据会上传到服务器吗？
不会。JSONSort 所有工具均在浏览器本地运行，您的输入内容不会发送到任何后端服务器。
需要注册或安装吗？
不需要。打开页面即可使用，无需账号、无需下载客户端，也支持 PWA 离线缓存。
支持多大的文件？
取决于浏览器内存，通常可流畅处理数 MB 级别的数据。超大文件建议先拆分或使用合并清理工具。