命令行里优雅地处理 JSON:jq 常用操作速查与实战

举报
yd_263393080 发表于 2026/11/15 20:39:45 2026/11/15
【摘要】 调接口、看日志、读配置,JSON 无处不在。很多人习惯把返回结果复制到网页格式化工具里再找字段,其实一个 jq 就能在终端里完成格式化、取值、过滤和改写。本文整理了日常最常用的 jq 用法,配合几个实战例子,10 分钟就能上手。 一、安装# Debian / Ubuntusudo apt install -y jq# CentOS / EulerOSsudo yum install -y j...

调接口、看日志、读配置,JSON 无处不在。很多人习惯把返回结果复制到网页格式化工具里再找字段,其实一个 jq 就能在终端里完成格式化、取值、过滤和改写。本文整理了日常最常用的 jq 用法,配合几个实战例子,10 分钟就能上手。

一、安装

# Debian / Ubuntu
sudo apt install -y jq
# CentOS / EulerOS
sudo yum install -y jq
# macOS
brew install jq

jq --version

二、准备一份示例数据

把下面内容保存为 servers.json:

{
  "region": "cn-north-4",
  "servers": [
    {"name": "web-01", "status": "ACTIVE",  "cpu": 2, "tags": ["web", "prod"]},
    {"name": "web-02", "status": "SHUTOFF", "cpu": 2, "tags": ["web", "test"]},
    {"name": "db-01",  "status": "ACTIVE",  "cpu": 8, "tags": ["db", "prod"]}
  ]
}

三、最常用的 6 个操作

1. 格式化输出

jq . servers.json

. 表示“整个输入”,jq 会自动缩进并高亮。加 -c 则压缩成一行,适合写进日志。

2. 取字段

jq '.region' servers.json          # "cn-north-4"
jq -r '.region' servers.json       # cn-north-4(-r 去掉引号,方便赋值给 shell 变量)
jq '.servers[0].name' servers.json # "web-01"

3. 遍历数组

jq -r '.servers[].name' servers.json

输出三行:web-01、web-02、db-01。[] 会把数组展开成多个结果。

4. 条件过滤:select

# 只看运行中的机器
jq -r '.servers[] | select(.status == "ACTIVE") | .name' servers.json

# 带 prod 标签的机器
jq -r '.servers[] | select(.tags | index("prod")) | .name' servers.json

| 是 jq 的管道,和 shell 里的含义一样:前一步的输出作为后一步的输入。

5. 重新组装结构

jq '[.servers[] | {name, cpu}]' servers.json

{name, cpu} 是 {name: .name, cpu: .cpu} 的简写,适合把冗长的接口返回裁剪成自己关心的字段。

6. 聚合计算

jq '[.servers[].cpu] | add' servers.json      # 总核数 12
jq '.servers | length' servers.json           # 机器数 3
jq '.servers | group_by(.status) | map({status: .[0].status, count: length})' servers.json

四、实战例子

例 1:从 curl 返回中提取 token

TOKEN=$(curl -s https://example.com/api/login -d '{"user":"demo"}' | jq -r '.data.token')
echo "$TOKEN"

-r 很关键,否则变量里会带上双引号。

例 2:把 JSON 转成 CSV,丢进表格

jq -r '.servers[] | [.name, .status, .cpu] | @csv' servers.json

输出:

"web-01","ACTIVE",2
"web-02","SHUTOFF",2
"db-01","ACTIVE",8

把 @csv 换成 @tsv 就是制表符分隔。

例 3:修改配置文件里的某个值

jq '.region = "cn-east-3"' servers.json > tmp.json && mv tmp.json servers.json

注意 jq 不会原地修改文件,需要先写到临时文件再替换。

例 4:用 shell 变量做参数

NAME=db-01
jq --arg n "$NAME" '.servers[] | select(.name == $n)' servers.json

用 --arg 传参,比把变量直接拼进过滤表达式更安全,也不用操心引号转义。

五、几个容易踩的坑

  1. 字段不存在不会报错:.foo 取不到时返回 null。需要兜底可以写 .foo // "默认值"。
  2. 单引号包住过滤表达式:jq 表达式里常有 $、|,用双引号会被 shell 提前解释。
  3. 数组为空时 add 返回 null:可以写成 ([.servers[].cpu] | add) // 0。
  4. 大文件流式处理:几百 MB 的 JSON 可以用 jq --stream,避免一次性读进内存。

六、小结

需求 写法
格式化 jq .
取值(无引号) jq -r '.a.b'
遍历数组 .list[]
过滤 select(条件)
裁剪字段 {name, cpu}
转 CSV @csv
传参 --arg k v + $k

掌握这几条,日常调接口、处理日志和改配置基本够用。下次再拿到一大坨 JSON,不妨先在终端里试试 jq。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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