jq 入门:命令行里处理 JSON 的五个姿势
接口返回一大坨 JSON,用 grep 猜字段、用 python 写临时脚本,都是绕路。jq 就是为这件事生的:一条管道把 JSON 变成你想要的样子。这篇只讲五个最常用的姿势,够覆盖九成日常。
一、美化与取字段
curl -s https://api.example.com/users | jq . 先把压缩成一行的 JSON 展开成缩进格式,肉眼就能读。加 -c 反过来压成一行,方便塞进日志或再传给别的命令。
取字段用 . 加上路径:jq '.data.items[0].name'。数组取全部用 .data.items[].name,注意 [] 会把数组摊平,这是 jq 最核心的语义。
二、构造新对象
jq '{id: .id, name: .name}' 从原对象里挑字段,拼成新结构。想改名就换键名,想加常量直接写字面量。批量处理时这个姿势最省事:jq -c '{id, name}' 就能把一份大响应裁成两列。
{id} 是 {id: .id} 的简写,字段名一致时可以省一半字符。
三、过滤与条件
jq '.items[] | select(.status == "failed")' 只留下失败项。多个条件用 and/or 组合,比如 select(.status == "failed" and .retry > 3)。
按值排序:sort_by(.created_at);取前十个:.[0:10];去重:unique_by(.id)。这些组合起来,就是一条不用写代码的数据清洗流水线。
四、聚合统计
想统计每个状态有多少条:jq '.items | group_by(.status) | map({status: .[0].status, n: length})'。理解 group_by 的前提是先用 sort_by 想清楚分组键,jq 内部也会排序,但显式写出来更不容易错。
求和用 add:jq '[.items[].amount] | add'。注意必须先用 [] 把字段收集成数组,否则 add 无从下手。
五、与 shell 协作
要拿字段做 shell 变量:name=$(curl -s $URL | jq -r '.data.name'),-r 去掉输出里的引号,否则变量会带上双引号。
要逐行处理:jq -r '.items[] | [.id, .name] | @tsv' 输出成制表符分隔,再接 while read 循环,比在 JSON 里硬解析干净得多。
五个姿势:看(.)、取(.a.b[])、造({k: .f})、筛(select)、聚(group_by/add)。熟练之后你会发现,很多「写个小脚本处理一下」的活儿,一条 jq 管道就够了,而且能直接放进 CI 或巡检脚本里复用。
- 点赞
- 收藏
- 关注作者
评论(0)