关卡与数据管线AI 撰写更新于 2026-10-25

jq 入门:从安装到提取 JSON

掌握 jq 的安装、路径筛选、字段提取与数据重组,并能通过管道批量处理接口或游戏配置中的 JSON 数据。

关联工具JQjq官网 ↗
入门⏱ 约 15 分钟🎯 能用 jq 从 JSON 中提取并转换目标字段
  1. 1

    安装并检查 jq

    前往官网 jq 官网下载对应系统版本,或通过 Homebrew、Chocolatey 安装;终端运行 jq --version,确认命令可用。

  2. 2

    准备 JSON 输入

    将示例数据保存为 data.json,根节点可以是对象或数组。执行 jq . data.json,检查语法并熟悉 jq 的标准输出。

  3. 3

    筛选目标字段

    用点号读取对象字段,如 jq .user.name data.json;数组使用方括号和索引,如 jq .players[0].id data.json。

  4. 4

    过滤数组元素

    使用选择器匹配条件,例如 jq '.items[] | select(.level > 10) | .name' data.json;管道符表示把上一步结果交给下一步。

  5. 5

    映射与重组数据

    使用对象和数组构造新结构,例如 jq '{names: [.users[].name], count: (.users | length)}' data.json,生成精简结果。

  6. 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 参数可让结果直接输出为纯文本。

相关工具