JQ

jq

用命令行筛选转换 JSON,串起 AI 资产管线。

JSON命令行数据转换自动化
所属分类🗺️ 关卡与数据管线
创作阶段🔗 工作流
工具类型传统工具 · AI 管线配套
支持平台Windows、macOS、Linux
价格模式免费开源
适合人群工具程序开发者、数据工程师、独立开发者
官网链接● 正常
资料更新2026-11-16

🧠 在 AI 创作链路中的位置

转换 AI 产出的结构化数据,使其符合游戏管线要求。

所属阶段:🔗 工作流 · 传统工具,负责把 AI 产物打磨/接入到可交付的管线里

工具介绍

免费开源的命令行 JSON 处理器,可通过简洁查询表达式筛选字段、重排结构、批量转换和输出数据。适合处理 AI 或引擎产生的角色、物品、对话与任务数据,并能接入 Shell、CI 和批处理流程,完成可复现的资产整理。

核心能力

  • 表达式筛选 JSON 字段
  • 批量重排与转换数据
  • 支持命令行管道组合
  • 便于接入自动化流程

👍 优点

  • 批处理效率高
  • 可复现且易自动化
  • 跨平台可用

⚠️ 局限

  • 学习表达式有门槛
  • 大型嵌套数据调试不便

典型使用场景

  • 整理 AI 对话数据
  • 转换物品与任务配置
  • 批量导出模型元数据
  • 接入资产校验脚本

使用教程

入门⏱ 约 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 提前解析表达式
  • 点号访问对象,数组索引从零开始

完整图文教程:jq 入门:从安装到提取 JSON

📖 同类工具怎么选

本分类负责把 AI 生成的视频、地图、数值表和资源包转化为可编辑、可校验、可集成的工程资产。应按目标引擎、资产格式、自动化程度与可回溯性选型,并先统一目录、命名和数据规范,再衔接生成、编辑、验证与发布流程。

阅读《AI游戏资产与关卡管线总览》

同类工具推荐