01
选择适合数据的读取方式
JSON 模式接受连续的 JSON 值；slurp 将它们收成数组。原始文本模式逐行读取，整段文本模式保留换行并形成一个字符串。null 模式从 null 开始，但 input 和 inputs 仍能读取提供的数据。
JSON 工具
jq 在线运行先验证过滤器，再带回脚本
输入 JSON 或文本，选择输入模式并手动运行；结果保留真实 stdout 和退出码。
jq 在线运行
JSON / 文本输入
jq 程序
结果
预览按 5,000 字符分批显示，复制和下载包含完整结果。
输入和程序仅在浏览器内存中处理，不保存历史记录。
允许 -c -r -j -S -a -e、组合短选项及对应长选项。-s/-R/-n 通过输入模式选择。
jq 1.8.2 · 本地 WebAssembly · 手动运行
结果已过期，复制和下载已禁用。
仅适用于 POSIX shell。先将输入保存为 input.json；复制的命令不含输入数据。
jq 在线运行适合在编写脚本之前验证接口响应的筛选条件：哪些记录应该保留，输出是多个值还是一个数组，都可以直接对照原输入检查。
通过 jq 在线调试确认程序行为，再复制命令到终端。这里的 jq 查询和 jq 过滤使用完整引擎，支持映射、函数、归约与错误处理，而不是只识别几个常见表达式。
为什么使用 jq 在线运行？
多个输出值不等于一个数组
.people[] | select(.age >= 18) | .name 会为每位成年人输出一个独立字符串。预览保留结果之间的换行，让你确认后续命令实际接收的内容。
明确收集输入还是收集结果
jq 在线运行中的 -s 会在执行程序前把所有 JSON 输入收集为一个数组。给过滤器加方括号则收集当前输入产生的结果，两者处理的阶段不同。
先确认输入与输出的形状
02
先查看替换预览，再主动执行
导入文件、加载示例或清空都会先显示替换预览。应用后可撤销一次，同时恢复输入、程序、选项和原结果。点击运行或按 Ctrl/Cmd+Enter；修改任一参数后，需要重跑才能导出。
03
检查退出码再带回终端
非零退出码会禁用导出，即使 -e 只是报告 false、null 或无输出。适用时移除 -e 后重新运行。复制的命令采用 POSIX 引号规则，需要先把相同输入保存为 input.json。
筛选、构造与流式结果
筛选条件与对象映射
select 保留符合条件的记录，map 构造一个转换后的数组。示例用数字年龄筛选成年人，也可生成包含姓名和布尔值的新对象。数字与包含数字的字符串并非同一种类型。
真实程序语法
本页运行 jq 1.8.2 WASM 引擎，支持管道、reduce、def、递归、try/catch 和正则表达式。没有将 jq 程序替换成 JavaScript 子集解释器；文件模块与附加文件参数未开放。
文本与格式控制
-r 输出不带 JSON 引号的字符串，-j 去除输出分隔符，-c 压缩 JSON，-S 排序键，-a 转义非 ASCII 字符。允许组合短选项和对应长选项，不支持的参数会明确拒绝。
原样输出与独立诊断
空白、开头的 BOM 和 NUL 字符保留在文本中。debug 与 stderr 显示在独立诊断区域。预览每次增加 5,000 个字符，正常导出包含完整结果而非当前可见片段。
数值、退出状态与资源边界
- 输入和执行预算
- 输入及文件最多 500,000 个 UTF-8 字节，程序最多 8,000 字节，选项最多 256 个字符。引擎加载限时 15 秒，加载完成后执行限时 3 秒；停止按钮会终止 Worker。
- 内存和输出不是无限的
- WASM 线性内存硬上限为 256 MiB，不代表整个浏览器的总内存上限。stdout 与 stderr 合计最多 2 MiB，在缓冲区扩容前检查。超时、栈、内存或输出超限不会提供可导出的部分结果。
- 数值和重复键遵循 jq
- 输入不会先经过 JavaScript JSON 解析。未经运算的大数值字面量可能保留原始十进制形式，参与浮点运算后仍可能舍入。重复键按 jq 的后键覆盖行为处理；需要精确保留的编号应使用字符串。
- 非零退出需要自行判断
- -e 通常以 1 表示 false/null，以 4 表示无结果，但 halt_error 也能返回这些代码。因此所有非零退出都禁止复制、下载和复制命令；原输出与诊断仍可查看，预览可能不完整。
- 不是完整的终端环境
- 不提供 --arg 编辑器、--stream、--seq、模块上传、文件系统浏览、URL 抓取或含数据的分享链接。命令仅适用于 POSIX shell；依赖环境的内置函数看到的是 WASM 环境，而非你的计算机环境。
jq 在线运行常见问题
如何用 jq 筛选 JSON 对象数组？
对示例使用 .people[] | select(.age >= 18) | .name。[] 逐个取出记录，select 保留匹配项，再用 .name 取字段。仅当后续步骤要求一个数组时，才给整个表达式加方括号。
如何去掉 jq 输出中的双引号，以便在 Bash 中解析 JSON 文件？
在输出选项中添加 -r。它去除字符串结果的 JSON 引号，但保留字符串内部的空格；对象和数组仍按 JSON 输出。如果连结果之间的分隔符也不要，再使用 -j。
如何把 jq select 操作的结果输出为数组？
使用 [.people[] | select(.age >= 18)]。方括号收集内部过滤器产生的所有值。没有匹配项时得到 []，而不是完全没有输出，这会影响后续脚本的处理方式。
如何将多个 JSON 对象合并成数组？
选择收集 JSON（-s），用 . 查看组成的数组。如果输入本身是多个数组，可以用 -s 配合 add 拼接；对象合并涉及同名键覆盖，不能把它与数组收集混为一谈。
如何将 key = value 键值对转换为 JSON？
选择逐行文本（-R），对简单格式可以从 split("=") | {(.[0]): .[1]} 开始，再按需去掉键和值的空格。如果值中也包含等号，需要不同的分割逻辑；不同配置格式的转义规则不能通用。
发现查询结果或语法处理不正确？