jq 一行取数:别再用 grep 啃 JSON 了

举报
yd_233022899 发表于 2026/11/07 12:09:39 2026/11/07
【摘要】 接口返回一串 JSON,日志里嵌着一层又一层对象,很多人第一反应是 grep 加 awk 硬啃。能啃动,但换个字段顺序、多个空格、嵌套一深,脚本就碎了。JSON 就该用理解 JSON 的工具处理,jq 就是命令行上最顺手的那把。 先确认装了没有jq --version多数发行版自带,没有就 apt install jq 或 yum install jq,macOS 用 brew instal...

接口返回一串 JSON,日志里嵌着一层又一层对象,很多人第一反应是 grep 加 awk 硬啃。能啃动,但换个字段顺序、多个空格、嵌套一深,脚本就碎了。JSON 就该用理解 JSON 的工具处理,jq 就是命令行上最顺手的那把。

先确认装了没有

jq --version

多数发行版自带,没有就 apt install jq 或 yum install jq,macOS 用 brew install jq。它只有一个二进制文件,没有依赖,拷到服务器上就能用。

最常用的三个动作

假设有个 resp.json:

{"code": 0, "data": {"name": "worker-01", "ip": "10.0.0.5", "tags": ["gpu", "beijing"]}, "msg": "ok"}

取字段用点号,一层层往下走:

jq '.data.name' resp.json        # "worker-01"
jq -r '.data.ip' resp.json       # 10.0.0.5,去掉引号
jq '.data.tags[0]' resp.json     # "gpu"

-r 输出原始字符串,不带引号,这是写脚本时最常用的开关。不加 -r,拿到的是带引号的 JSON 字符串,再往别的命令里传很容易多一层引号,排错时先看是不是这里的问题。

数组是 jq 的主场

接口常返回列表,比如查一批机器的状态:

{"items": [{"name": "a", "status": "running"}, {"name": "b", "status": "stopped"}]}

.[] 表示展开数组,配合 select 做过滤:

jq -r '.items[] | select(.status == "stopped") | .name' resp.json
# b

这一行做了三件事:展开、过滤、取值。管道的思路和 shell 一样,前面输出什么,后面就处理什么。需要个数就再接 length:

jq '.items | length' resp.json
jq '[.items[] | select(.status == "running")] | length' resp.json

注意第二个例子里先用 [] 把过滤结果收成数组再数个数,直接对流用 length 会报错,这是新手最常踩的坑。

和 curl 拼起来

线上排错最常见的组合就是 curl | jq:

curl -s http://127.0.0.1:8080/health | jq '.'

最后那个 . 是原样美化输出,比 python -m json.tool 少敲很多字。只关心某几个字段时直接取出来:

curl -s http://127.0.0.1:8080/api/nodes | jq -r '.nodes[] | "\(.name) \(.ip) \(.status)"'

用 "\(...)" 做字符串插值,一行输出一个节点,awk 能接、眼睛也能读。服务挂了的时候,先看 curl 的退出码再怪 jq:空输入会报 parse error,先确认接口真的返回了东西。

改数据、拼新结构

jq 不只能读,还能改。给对象加字段、改值、删字段:

jq '.data.region = "cn-north-4"' resp.json
jq 'del(.msg)' resp.json
jq '{name: .data.name, ip: .data.ip}' resp.json

最后一个是构造新对象,只留需要的字段,输出干净的 JSON 给下游程序。写部署脚本时,用它从接口响应里拼出配置,比 sed 替换模板稳得多。

几个容易踩的坑

第一,jq 读的是标准输入或文件,二者别混着写;jq '.a' file.json 是对的,cat file.json | jq '.a' file.json 会多读一次文件。

第二,数字和字符串分得清清楚楚,select(.code == 0) 里的 0 不能加引号,加了引号就永远匹配不上。

第三,输出到文件记得加 -r 或确认格式,否则带引号的字符串写进配置文件,下游程序读到的就是 "10.0.0.5" 含引号的版本。

第四,大文件别怕,jq 是流式读的,几百兆的日志文件用 . | select(...) 一行行过,内存不会爆;但别在管道里套 sort 之类要全量数据的操作,流式优势就没了。

小结

grep 擅长处理行,jq 擅长处理结构。接口返回、日志文件、配置文件,只要内容是 JSON,就让 jq 来取数:点号取字段、.[] 展开数组、select 过滤、-r 去引号,这四招覆盖了日常九成场景。剩下一成再去翻手册也不迟。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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