命令行里优雅地处理 JSON:jq 常用操作速查与实战
【摘要】 调接口、看日志、读配置,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 传参,比把变量直接拼进过滤表达式更安全,也不用操心引号转义。
五、几个容易踩的坑
- 字段不存在不会报错:
.foo取不到时返回null。需要兜底可以写.foo // "默认值"。 - 单引号包住过滤表达式:jq 表达式里常有
$、|,用双引号会被 shell 提前解释。 - 数组为空时
add返回 null:可以写成([.servers[].cpu] | add) // 0。 - 大文件流式处理:几百 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)