jq 3 步装好Windows、Linux、macOS 安装验证与 JSON 命令行处理【免费下载链接】jqCommand-line JSON processor项目地址: https://gitcode.com/GitHub_Trending/jq/jqjq 是一个用 C 语言写的命令行 JSON 处理器读文件、取字段、改结构一条命令就能完成。本文按装好 → 验证 → 用熟 → 排错走一遍走完你可以自己完成 jq 的跨平台安装并处理日常遇到的 API 响应、日志里的 JSON。按系统装 jq三个系统各有一条最短路径优先用官方包或预编译文件只有改源码时才需要从源码编译——那套流程长还容易缺依赖。Windows 安装 jq预编译 exe 或包管理器二选一最省事下预编译文件到 jq 发布页下载jq-win64.exe32 位老系统下jq-win32.exe改名为jq.exe放进固定目录比如C:\Tools把C:\Tools加进系统 PATH第 3 步不能省Windows 只在 PATH 列出的目录里找可执行文件漏了它终端敲jq就会报不是内部或外部命令。更省心包管理器代劳choco install jq或scoop install jq包管理器会把 jq 直接放进 PATH 能找到的位置省掉手动改环境变量这一步。Linux 安装 jqapt 或 yum 一行命令Ubuntu/Debian 系sudo apt update sudo apt install jqCentOS/RHEL 系sudo yum install jqapt 那条特意加了update不先刷新软件源索引装到的可能是旧版本。需要自己编译时仅改源码、打补丁才需要clone 仓库后在源码目录依次执行git clone https://gitcode.com/GitHub_Trending/jq/jq cd jq autoreconf -i ./configure --with-onigurumabuiltin make -j8 sudo make install--with-onigurumabuiltin表示让 jq 自带正则库不用系统另外装 oniguruma。macOS 安装 jqbrew 一行命令brew install jqbrew 会把 jq 装进 PATH 能找到的目录装完直接能用机器上只有 MacPorts 的话换成sudo port install jq。装完 jq 先验证两条命令确认能跑通别急着上手路径没配好的话现在不测等写脚本写到一半才炸排查起来更麻烦。第一条确认版本jq --version正常会打印类似jq-1.8.2的版本号。第二条建一个test.json内容只有一行{name: jq}然后取字段jq .name test.json输出jq说明读文件、解析、取字段整条链路都通了。第一条就报 not found直接跳到最后一节查 PATH。jq 高频用法提取、过滤、格式化以下示例用同一个users.json内容是[{name: a, status: on}, {name: b, status: off}]。提取单个字段——把第一个人的名字取出来jq .[0].name users.json过滤数组——只留 status 为 on 的select会把不满足条件的元素丢掉jq .[] | select(.status on) users.json取出一列——只要所有人的名字jq .[].name users.json美化输出——默认把 JSON 缩进展开方便肉眼检查jq . config.json加-c则压成单行管道传给下一个工具更合适jq -c . config.json数数组长度jq length users.jsonjq 报错自救三种情况对照处理现象多半的原因处理办法command not found或不是内部或外部命令jq 所在目录不在 PATHWindows 加完 PATH 要重开终端Linux/macOS 先跑which jq没输出就是没装上或不在 PATHparse error输入不是合法 JSON多了尾逗号、用了单引号先单独跑jq . 文件名定位是哪个文件坏记住 JSON 只认双引号表达式报unexpected tokenshell 把引号吃掉了PowerShell 外层用单引号CMD 用双引号jq .nameLinux/macOS 外层单引号最稳自己编译出来的二进制如果提示没有权限chmod x补一下执行权限就能跑。下一步拿手头任意一个 JSON 文件跑一遍jq . 文件名再挑一个字段用.字段名提出来练手。【免费下载链接】jqCommand-line JSON processor项目地址: https://gitcode.com/GitHub_Trending/jq/jq创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考