jq 入门:命令行里处理 JSON 的五个姿势

举报
yd_213494201 发表于 2026/11/16 01:20:30 2026/11/16
【摘要】 接口返回一大坨 JSON,用 grep 猜字段、用 python 写临时脚本,都是绕路。jq 就是为这件事生的:一条管道把 JSON 变成你想要的样子。这篇只讲五个最常用的姿势,够覆盖九成日常。 curl -s https://api.example.com/users | jq . 先把压缩成一行的 JSON 展开成缩进格式,肉眼就能读。加 -c 反过来压成一行,方便塞进日志或再传给别的命令。

接口返回一大坨 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 或巡检脚本里复用。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。