jq 安装与上手指南：5 条核心命令快速搞定 JSON 处理

jq 安装与上手指南5 条核心命令快速搞定 JSON 处理【免费下载链接】jqCommand-line JSON processor项目地址: https://gitcode.com/GitHub_Trending/jq/jqjq 是一款命令行 JSON 处理器用于过滤、转换和格式化 JSON 数据适合开发者、数据分析师与运维工程师。这篇 jq 入门教程覆盖 jq 怎么安装Windows、macOS、Linux 三种系统以及如何写出你的第一条 JSON 处理命令。为什么选 jq巨型 JSON 难以人工阅读。一份几千行的接口响应在编辑器里翻半天才能定位到目标字段。jq 用一条命令把任意 JSON 重新缩进排版结构一目了然jq . data.json跨系统脚本需要统一工具。开发机、CI、生产服务器上可用的工具各不相同JSON 提取逻辑没法复用。jq 在 Windows、macOS、Linux 上行为完全一致同一套命令随处可跑。手工提取字段容易出错。用 sed/grep 硬掰嵌套结构换个字段顺序就全乱。jq 按路径取字段与字段顺序无关取错路径也会给出明确报错。不同系统的 jq 安装方法在 Windows 上安装 jq从官方发布资源中获取 Windows 预编译可执行文件如 jq-windows-amd64.exe即可直接运行更省事的是用包管理器一行装好scoop install jq安装完成后重启终端使其生效。在 macOS 上安装 jqmacOS 上最直接的 jq 安装方式是 Homebrewbrew install jq若机器没有 Homebrew也可以参考下面 Linux 一节用源码构建。在 Linux 上安装 jqUbuntu/Debian 用 aptCentOS/RHEL 用 dnf 或 yumsudo apt install jq发行版版本过旧时可从源码构建git clone https://gitcode.com/gh_mirrors/jq/jq cd jq autoreconf -i ./configure make验证安装与首次实测先确认 jq 是否安装成功能打印出版本号即通过jq --version echo {name:Alice,age:30} | jq .name第二条命令是 jq 提取字段的最小示例只返回字段值本身不带引号包裹的 JSON 符号。再试两条更常用的echo {tags:[dev,ops]} | jq .tags[] jq . data.json第一条把数组元素逐个展开是处理列表的基础语法第二条把data.json美化输出同时会校验文件是否为合法 JSON不合法时直接报出错误位置。高频操作速查提取嵌套字段jq .data.id遍历数组元素jq .items[]按条件筛选记录jq .items[] | select(.status active)给对象新增字段jq . {updated: 1700000000}压缩为单行输出方便接管道给下游工具jq -c .这些语法可以自由组合例如jq -c .items[] | select(.age 18)。仓库里 tests/jq.test 收录了大量真实表达式的输入输出对照适合照着练习。常见问题排查Q安装后终端提示jq: command not found多半是 PATH 未生效。Windows 上检查可执行文件所在目录是否加入 PATH然后重启终端Linux/macOS 可用which jq确认实际安装位置。Q安装过程中途失败先排查网络与镜像源重试或换源即可解决大部分问题源码构建失败时确认 gcc、make、autoconf 等构建依赖是否齐全。Q查询返回 null 或与预期不符先用jq keys和jq type查看数据结构核对路径的层级和拼写再执行。jq 路径错了会安静地返回 null而不是报错所以先确认结构再取字段。以上流程跑通后jq 安装与基础使用就算完成了。想继续深入可以翻阅 docs/content/manual/ 里的官方手册源文件或直接运行 tests/ 中的测试集观察各类表达式的实际行为。【免费下载链接】jqCommand-line JSON processor项目地址: https://gitcode.com/GitHub_Trending/jq/jq创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考