JSON命令行处理器

技能简介

jq 是一款轻量级命令行 JSON 处理器，用于在终端中快速提取、过滤和转换 JSON 数据。无需编写复杂代码即可完成嵌套查询、条件筛选、字段重组等操作。

能做什么

• 从 JSON 文件中提取指定字段或嵌套值
• 按条件过滤数组元素
• 转换数据结构并输出为新格式
• 合并多个 JSON 文件内容
• 美化或压缩 JSON 输出

使用说明

安装步骤

macOS / Linux（Homebrew）：

brew install jq

其他平台：访问 jqlang.org/download 获取安装包或编译指南。

基础用法

# 直接处理文件
jq '[filter]' [file.json]

# 管道输入
cat file.json | jq '[filter]'

常用过滤器示例

.key              # 获取键值
.a.b.c            # 嵌套访问
.[0]              # 取数组首项
.[]               # 遍历数组
select(.x > 5)    # 条件筛选
{a: .x, b: .y}    # 重构对象
del(.key)         # 删除字段
length            # 统计数量

常用参数：-r 原始输出（去除引号）、-c 压缩格式、-s 合并为数组、-S 按键排序。

输入与输出

见下方输入与输出表格。

风险提示

• 处理大型 JSON 文件时可能占用较多内存
• 复杂过滤器语法需验证后再用于生产环境
• 管道操作注意字符编码一致性

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/gumadeiras/jq/SKILL.md
来源类型：GitHub 仓库