# JSON 转 Query String

根据 JSON 对象生成 URL 查询字符串。所有值都会进行百分号编码；嵌套对象使用 filter[status]=open 这样的方括号记法；数组则可写为重复键、带方括号、带索引或逗号分隔的列表。可选择用 %20 或 + 表示空格，以匹配读取 URL 的服务器。

## 常见问题

### 有哪些数组格式可选？

Repeat 格式会生成 ids=1&ids=2；brackets 格式会生成 ids[]=1&ids[]=2；indices 格式会生成 ids[0]=1&ids[1]=2；comma 格式会生成 ids=1,2。URLSearchParams 和大多数 HTTP 客户端都会发送 Repeat 格式；PHP 和 Rails 则要求使用方括号或索引格式。

### 嵌套对象如何写入？

使用方括号表示法：{"filter": {"status": "open"}} 会变成 filter[status]=open。更深层的对象会增加更多方括号，例如 a[b][c]=1。

### 空格应该写成 %20 还是 +？

在查询字符串中，两者都表示空格。%20 在 URL 的任何部分都适用，而 + 是 HTML 表单会发送的形式。大多数服务器两种都接受，因此请根据服务器或 API 文档选择。

### 为什么方括号会被编码为 %5B 和 %5D？

方括号是 URL 中的保留字符，因此默认会进行百分号编码，例如 PHP 的 http_build_query 和 qs 库都会这样处理。启用可读方括号后，它们会保留为 [ 和 ]，大多数服务器也能接受这种形式。

### 哪些字符不会被编码？

字母、数字以及 - _ . ! ~ * ' ( ) 会保持原样。其他所有字符，包括 &, =, # 和非 ASCII 字母，都会按 UTF-8 进行百分号编码。

### null 和布尔值如何表示？

true、false 和数字会写成文本，例如 active=true。null 会变成空值，例如 note=。

在这里投放广告？

[给我们发邮件](mailto:hi@dennn.is?subject=%E5%9C%A8%20OneClick%20Pro%20%E4%B8%8A%E6%8A%95%E6%94%BE%E5%B9%BF%E5%91%8A)

[广告 通过一个 MCP 服务器为你的 AI 代理提供 433 种工具。](https://multitaskai.com/zh/?ref=oneclickpro)
