名称： jq
描述： 命令行 JSON 处理器。用于提取、筛选和转换 JSON 数据。

jq

用于提取、筛选和转换 JSON 数据的命令行处理器。

安装

macOS / Linux (使用 Homebrew):

brew install jq

所有平台: 请访问 jqlang.org/download 查看软件包、二进制文件及构建指南。

基本用法

jq '[过滤器]' [文件.json]
cat 文件.json | jq '[过滤器]'

快速参考

.key                    # 获取键值
.a.b.c                  # 嵌套访问
.[0]                    # 第一个元素
.[]                     # 遍历数组
.[] | select(.x > 5)    # 筛选
{a: .x, b: .y}          # 重构对象
. + {new: "val"}        # 添加字段
del(.key)               # 删除字段
length                  # 计数
[.[] | .x] | add        # 求和
keys                    # 列出所有键
unique                  # 数组去重
group_by(.x)            # 分组

常用标志

-r 原始输出（无引号） · -c 紧凑格式 · -s 将输入合并为数组 · -S 按键名排序

示例

jq '.users[].email' data.json          # 提取所有邮箱
jq -r '.name // "default"' data.json   # 提取名称，若无则使用默认值
jq '.[] | select(.active)' data.json   # 筛选活跃项
jq -s 'add' *.json                     # 合并多个 JSON 文件
jq '.' file.json                       # 格式化输出（美化打印）