chatwork/jq

jq Docker镜像文档

镜像概述

jq是一款功能强大的命令行JSON处理工具，支持对JSON数据进行解析、过滤、转换和查询操作。本Docker镜像封装了jq工具，可直接通过容器运行，避免本地环境依赖，简化跨平台使用流程，适用于需要快速处理JSON数据的场景。

核心功能与特性

• JSON解析：支持解析复杂JSON结构，包括嵌套对象、数组等
• 数据过滤：通过表达式提取特定字段或满足条件的数据
• 格式转换：支持JSON格式化、重组、排序及计算（如求和、计数）
• 轻量级：容器体积小，启动速度快，资源占用低
• 无依赖运行：无需本地安装jq，直接通过Docker容器执行

使用场景

• 命令行快速处理API返回的JSON数据
• 自动化脚本中解析配置文件或日志的JSON内容
• CI/CD流程中处理JSON格式的配置或输出结果
• 跨平台环境中保持一致的JSON处理能力，避免版本差异

使用方法

基本用法

通过管道输入JSON数据并执行jq查询：

bash
# 输出整个JSON对象
echo '{"foo": 1, "bar": {"baz": 2}}' | docker run -i chatwork/jq .

# 提取指定字段（如提取bar.baz的值）
echo '{"foo": 1, "bar": {"baz": 2}}' | docker run -i chatwork/jq '.bar.baz'

参数说明

• -i：保持标准输入（STDIN）打开，允许通过管道向容器输入JSON数据
• jq查询表达式：紧跟镜像名的部分（如.、.bar.baz），用于指定数据处理规则，具体语法可参考https://stedolan.github.io/jq/manual/

处理本地文件

通过挂载本地文件到容器，处理文件中的JSON数据：

bash
# 假设本地有data.json文件，提取所有name字段
docker run -i -v $(pwd)/data.json:/data.json chatwork/jq '.[].name' /data.json

复杂查询示例

过滤数组中满足条件的元素：

bash
# 输入JSON数组，提取age>25的对象
echo '[{"name":"Alice","age":30},{"name":"Bob","age":25},{"name":"Charlie","age":35}]' | docker run -i chatwork/jq '.[] | select(.age > 25)'

输出结果：

json
{"name":"Alice","age":30}
{"name":"Charlie","age":35}

注意事项

• 输入大文件时建议使用文件挂载方式（如-v参数），避免管道输入效率问题
• 复杂查询表达式可通过单引号包裹，避免Shell解析冲突
• 如需持久化处理结果，可通过重定向输出到本地文件：

  bash
  echo '{"data": [1,2,3]}' | docker run -i chatwork/jq '.data[] * 2' > result.txt