jq 入门:从安装到提取 JSON
掌握 jq 的安装、路径筛选、字段提取与数据重组,并能通过管道批量处理接口或游戏配置中的 JSON 数据。
- 1
安装并检查 jq
前往官网 jq 官网下载对应系统版本,或通过 Homebrew、Chocolatey 安装;终端运行 jq --version,确认命令可用。
- 2
准备 JSON 输入
将示例数据保存为 data.json,根节点可以是对象或数组。执行 jq . data.json,检查语法并熟悉 jq 的标准输出。
- 3
筛选目标字段
用点号读取对象字段,如 jq .user.name data.json;数组使用方括号和索引,如 jq .players[0].id data.json。
- 4
过滤数组元素
使用选择器匹配条件,例如 jq '.items[] | select(.level > 10) | .name' data.json;管道符表示把上一步结果交给下一步。
- 5
映射与重组数据
使用对象和数组构造新结构,例如 jq '{names: [.users[].name], count: (.users | length)}' data.json,生成精简结果。
- 6
接入管道并保存
将 curl 获取的接口数据交给 jq,如 curl -s https://example.com/api | jq '.data[] | {id, name}';用重定向保存为 result.json。
💡 实用技巧
- 先运行 jq . 验证输入格式
- 用 --arg 传入外部变量
- 用 -r 直接输出纯文本
- 复杂查询拆成多段管道
⚠️ 常见坑
- 单引号可避免 Shell 提前解析表达式
- 点号访问对象,数组索引从零开始
常见问题
Q:Windows 上安装后提示找不到 jq 命令怎么办?
确认已通过官网或 Chocolatey 安装,并重新打开终端,再运行 jq --version 检查;若仍无法识别,请检查安装目录是否已加入系统 PATH。
Q:怎样从玩家数组中取出指定角色的编号?
数组索引从零开始,例如运行 jq '.players[0].id' data.json,可提取第一个玩家的 id;要处理多个玩家,可将索引改为 .players[]。
Q:如何筛选高等级素材并批量导出名称?
运行 jq -r '.items[] | select(.level > 10) | .name' data.json;管道会依次筛选并提取名称,-r 参数可让结果直接输出为纯文本。