jq 在线工具
有效
JSON 输入
输出
Loading editor...
Loading editor...
| 过滤器 | 说明 |
|---|---|
| 格式化输出整个文档 | |
| 遍历数组的每个元素 | |
| 按路径读取嵌套值 | |
| 仅保留满足条件的元素 | |
| 转换数组的每个元素 | |
| 列出对象的键 | |
| 将对象转换为键/值对 | |
| 按字段对元素分组并计数 | |
| 按字段对数组排序 | |
| 统计数组元素数量 | |
| 将行格式化为 CSV(需启用“原始输出”) | |
| 对字符串进行 Base64 编码(需启用“原始输出”) | |
| 列出所有数值的路径 | |
| 递归收集所有数字 | |
| 用 reduce 对值求和 | |
| 使用空输入读取所有输入(可尝试多个 JSON 文档) |
技术详情
jq 在线工具的工作原理
工具的功能
jq 在线工具会在你输入时对 JSON 运行真正的 jq 过滤器。jq 1.8 被编译为 WebAssembly 并在 Web Worker 中执行,因此结果(包括错误信息)与命令行工具完全一致。粘贴 JSON,编写过滤器,例如 .users[] | select(.age > 30) | .name,稍作停顿后输出就会更新。选项直接对应 jq 标志:原始输出 (-r)、紧凑 (-c)、slurp (-s)、空输入 (-n)、排序键 (-S)、制表符缩进 (--tab) 以及具名的 --arg 变量。
常见使用场景
开发者用它在将过滤器放入 shell 脚本、CI 流水线以及 Kubernetes 或 AWS CLI 单行命令之前进行原型验证,探索大型 API 响应和日志行,使用 @csv 将 JSON 转换为 CSV,使用 map、group_by 和 reduce 重塑数据,并通过内置的可点击示例速查表学习 jq。
输入、输出和标志
输入可以是单个 JSON 文档,也可以是多个拼接的文档(如 NDJSON);使用 Slurp 时它们会被包装成一个数组,使用空输入时则通过 input 和 inputs 自行读取。每个结果单独占一行输出。原始输出会不带引号地打印字符串,这对于 @csv、@tsv、@base64 和 @uri 输出是必需的。通过 --arg 传入的值在过滤器中以 $name 的形式使用,并且始终是字符串。
陷阱与限制
输入限制为 5 MB,运行 10 秒后会被停止,以免无限循环的过滤器冻结页面。数字按 jq 的双精度语义处理,因此超过 2^53 的整数可能丢失精度。这里不需要 shell 引号处理:在终端中请用单引号包裹过滤器。此在线工具不支持 jq 模块、从文件导入或环境变量。