jq 完整配置教程三大系统安装与 JSON 处理 10 分钟上手【免费下载链接】jqCommand-line JSON processor项目地址: https://gitcode.com/GitHub_Trending/jq/jqjq 是一个命令行 JSON 处理器用一条命令就能完成对结构化数据的提取、过滤与转换用 C 语言编写没有运行时依赖。本文按 Windows、Linux、macOS 三套系统逐步演示 jq 安装、版本选择、验证与第一次实际使用十分钟即可上手处理 JSON 文件。 安装前先做版本与渠道选择当前稳定版是 1.8.2各操作系统都提供对应构建建议直接安装最新版除非你要与某台旧服务器上的 jq 1.8.0 或 1.8.1 严格对齐输出。按使用场景选渠道日常开发用系统自带的包管理器升级维护最省心内网或受限环境从官方发布页下载对应架构的预编译二进制离线拷贝即可运行需要静态链接或定制编译选项从源码构建。各平台的完整下载渠道清单整理在 docs/content/download/default.yml可以按系统对照选择。 Windows 上安装 jq用包管理器一条命令安装winget install jqlang.jq在终端里执行后winget 会自动下载并完成安装无需手动配置 PATH安装完成提示成功后直接可用。如果机器上已有 Scoop 或 Chocolatey也可以分别执行scoop install jq choco install jq两者同样是自动下载、自动落盘装完jq就在全局命令路径里。下载预编译 exe没有包管理器时从发布页取jq-windows-amd64.exeARM64 设备取jq-windows-arm64.exe老 32 位系统取jq-windows-i386.exe。下载后建议把它重命名为jq.exe再放进一个已加入系统 PATH 的目录例如C:\tools。验证方式见下节。Windows 常见安装问题终端提示找不到 jq多半是文件没放进 PATH 目录或改名后忘了加.exe后缀PowerShell 与 CMD 对引号的处理不同过滤表达式本身含双引号时用单引号包住整个表达式或对内层双引号做转义能避免大部分解析报错。 Linux 上安装 jq用发行版包管理器安装sudo apt update sudo apt install jqUbuntu、Debian 上执行后先从源里刷新索引再装包装完立即能用。其他发行版对应命令sudo dnf install jq sudo pacman -S jq sudo zypper install jq这三条分别用于 Fedora/RHEL 系、Arch 系和 openSUSE 系都是装官方仓库里的 jq版本由发行版决定。FreeBSD 上则用pkg install jq安装预编译包。源码编译安装需要定制或复现构建时按官方流程走依赖 libtool、make、automake、autoconfgit clone https://gitcode.com/GitHub_Trending/jq/jq cd jq拉取源码树cd jq进入项目目录后续命令都在这里执行。git submodule update --init初始化子模块把编译所需的 oniguruma 正则库拉进vendor/目录。autoreconf -i重新生成 configure 脚本仅在直接基于 git 源码构建时需要如果你用的是发布 tarball这一步可跳过也不需要 flex 和 bison。./configure --with-onigurumabuiltin配置构建参数builtin表示把随仓库分发的 oniguruma 一起编入省去单独装库的麻烦。make -j8 make check sudo make install前三条依次是用 8 个并行任务编译跑一遍仓库自带的测试用例全部通过再安装最后将 jq 装进系统路径。如果你之前从源码装过旧版本先执行make clean再走上面流程避免残留文件干扰。想要一个不依赖系统库的独立文件可以make LDFLAGS-all-static静态链接后生成的 jq 可执行文件拷到任何同架构机器都能直接跑。Linux 常见安装问题包管理器装的版本偏旧但够用不必盲目追新二进制方式安装后若提示无权限执行先chmod x jq再运行。 macOS 上安装 jq用 Homebrew 或 MacPorts 安装brew install jqHomebrew 会拉取当前版本的 jq 并自动处理依赖完成后终端里直接可用。使用 MacPorts 的用户执行sudo port install jqMacPorts 需要 root 权限写入自己的库目录装完同样开箱即用。下载预编译二进制与架构选择不想装包管理器时从发布页按芯片取文件Apple SiliconM 系列选jq-macos-arm64Intel Mac 选jq-macos-amd64。取错架构能装上也可能跑不起来用uname -m先确认自己是arm64还是x86_64。下载后按需赋予执行权限chmod x jqmacOS 上从网上下载的二进制有时不带可执行位加完后把 jq 放到~/bin或/usr/local/bin这类 PATH 目录即可。✅ 验证安装并完成第一次 JSON 处理确认版本jq --version预期输出形如jq-1.8.2看到版本号说明安装成功且与目标版本一致。跑一个最小示例echo {name: jq, version: 1.8.2} | jq .name把一行 JSON 从标准输入交给 jq.name取出 name 字段预期输出jq。能正常输出即代表解析、过滤链路全部打通。三个最常用的表达式jq .database.host config.json按路径取嵌套字段输出对应值。jq .[] | select(.status active) users.json遍历数组并只保留 status 为 active 的对象是过滤列表数据的高频写法。jq -c . messy.json把任意 JSON 重新格式化输出-c切换为紧凑单行模式适合管道传给下一个工具再加-r则输出不带引号的原始文本。想查完整函数列表内置函数定义在 src/builtin.jq回归测试用例集中在 tests/ 目录里面大量现成表达式可以直接照着改。 版本、依赖与安全说明jq 遵循 MIT 协议授权文本见 COPYING其中十进制浮点支持使用了 ICU 协议的 decNumber C 库商用无碍。正则依赖 oniguruma 在构建时用--with-onigurumabuiltin内置运行时零外部依赖这也是它能在容器和离线环境里拷过去就能跑的原因。仓库自带 Dockerfile官方还发布 Docker 镜像适合在 CI 里固定版本使用。离线拿二进制后建议校验完整性每个版本目录如 sig/v1.8.2/下都有sha256sum.txt和签名文件用sha256sum -c sha256sum.txt比对哈希即可确认文件未被篡改。收尾下一步行动到这里三个系统的 jq 安装、验证与基础用法已经齐了。建议接下来做三件事用真实的 API 响应或配置文件跑一遍上面的过滤表达式把常用表达式存成带参数的 shell 脚本或别名遇到复杂需求时翻 tests/ 里的现成用例照着改。把这些固化进日常工作流后处理 JSON 就不必再开浏览器或写临时脚本了。【免费下载链接】jqCommand-line JSON processor项目地址: https://gitcode.com/GitHub_Trending/jq/jq创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
jq 完整配置教程：三大系统安装与 JSON 处理 10 分钟上手
jq 完整配置教程三大系统安装与 JSON 处理 10 分钟上手【免费下载链接】jqCommand-line JSON processor项目地址: https://gitcode.com/GitHub_Trending/jq/jqjq 是一个命令行 JSON 处理器用一条命令就能完成对结构化数据的提取、过滤与转换用 C 语言编写没有运行时依赖。本文按 Windows、Linux、macOS 三套系统逐步演示 jq 安装、版本选择、验证与第一次实际使用十分钟即可上手处理 JSON 文件。 安装前先做版本与渠道选择当前稳定版是 1.8.2各操作系统都提供对应构建建议直接安装最新版除非你要与某台旧服务器上的 jq 1.8.0 或 1.8.1 严格对齐输出。按使用场景选渠道日常开发用系统自带的包管理器升级维护最省心内网或受限环境从官方发布页下载对应架构的预编译二进制离线拷贝即可运行需要静态链接或定制编译选项从源码构建。各平台的完整下载渠道清单整理在 docs/content/download/default.yml可以按系统对照选择。 Windows 上安装 jq用包管理器一条命令安装winget install jqlang.jq在终端里执行后winget 会自动下载并完成安装无需手动配置 PATH安装完成提示成功后直接可用。如果机器上已有 Scoop 或 Chocolatey也可以分别执行scoop install jq choco install jq两者同样是自动下载、自动落盘装完jq就在全局命令路径里。下载预编译 exe没有包管理器时从发布页取jq-windows-amd64.exeARM64 设备取jq-windows-arm64.exe老 32 位系统取jq-windows-i386.exe。下载后建议把它重命名为jq.exe再放进一个已加入系统 PATH 的目录例如C:\tools。验证方式见下节。Windows 常见安装问题终端提示找不到 jq多半是文件没放进 PATH 目录或改名后忘了加.exe后缀PowerShell 与 CMD 对引号的处理不同过滤表达式本身含双引号时用单引号包住整个表达式或对内层双引号做转义能避免大部分解析报错。 Linux 上安装 jq用发行版包管理器安装sudo apt update sudo apt install jqUbuntu、Debian 上执行后先从源里刷新索引再装包装完立即能用。其他发行版对应命令sudo dnf install jq sudo pacman -S jq sudo zypper install jq这三条分别用于 Fedora/RHEL 系、Arch 系和 openSUSE 系都是装官方仓库里的 jq版本由发行版决定。FreeBSD 上则用pkg install jq安装预编译包。源码编译安装需要定制或复现构建时按官方流程走依赖 libtool、make、automake、autoconfgit clone https://gitcode.com/GitHub_Trending/jq/jq cd jq拉取源码树cd jq进入项目目录后续命令都在这里执行。git submodule update --init初始化子模块把编译所需的 oniguruma 正则库拉进vendor/目录。autoreconf -i重新生成 configure 脚本仅在直接基于 git 源码构建时需要如果你用的是发布 tarball这一步可跳过也不需要 flex 和 bison。./configure --with-onigurumabuiltin配置构建参数builtin表示把随仓库分发的 oniguruma 一起编入省去单独装库的麻烦。make -j8 make check sudo make install前三条依次是用 8 个并行任务编译跑一遍仓库自带的测试用例全部通过再安装最后将 jq 装进系统路径。如果你之前从源码装过旧版本先执行make clean再走上面流程避免残留文件干扰。想要一个不依赖系统库的独立文件可以make LDFLAGS-all-static静态链接后生成的 jq 可执行文件拷到任何同架构机器都能直接跑。Linux 常见安装问题包管理器装的版本偏旧但够用不必盲目追新二进制方式安装后若提示无权限执行先chmod x jq再运行。 macOS 上安装 jq用 Homebrew 或 MacPorts 安装brew install jqHomebrew 会拉取当前版本的 jq 并自动处理依赖完成后终端里直接可用。使用 MacPorts 的用户执行sudo port install jqMacPorts 需要 root 权限写入自己的库目录装完同样开箱即用。下载预编译二进制与架构选择不想装包管理器时从发布页按芯片取文件Apple SiliconM 系列选jq-macos-arm64Intel Mac 选jq-macos-amd64。取错架构能装上也可能跑不起来用uname -m先确认自己是arm64还是x86_64。下载后按需赋予执行权限chmod x jqmacOS 上从网上下载的二进制有时不带可执行位加完后把 jq 放到~/bin或/usr/local/bin这类 PATH 目录即可。✅ 验证安装并完成第一次 JSON 处理确认版本jq --version预期输出形如jq-1.8.2看到版本号说明安装成功且与目标版本一致。跑一个最小示例echo {name: jq, version: 1.8.2} | jq .name把一行 JSON 从标准输入交给 jq.name取出 name 字段预期输出jq。能正常输出即代表解析、过滤链路全部打通。三个最常用的表达式jq .database.host config.json按路径取嵌套字段输出对应值。jq .[] | select(.status active) users.json遍历数组并只保留 status 为 active 的对象是过滤列表数据的高频写法。jq -c . messy.json把任意 JSON 重新格式化输出-c切换为紧凑单行模式适合管道传给下一个工具再加-r则输出不带引号的原始文本。想查完整函数列表内置函数定义在 src/builtin.jq回归测试用例集中在 tests/ 目录里面大量现成表达式可以直接照着改。 版本、依赖与安全说明jq 遵循 MIT 协议授权文本见 COPYING其中十进制浮点支持使用了 ICU 协议的 decNumber C 库商用无碍。正则依赖 oniguruma 在构建时用--with-onigurumabuiltin内置运行时零外部依赖这也是它能在容器和离线环境里拷过去就能跑的原因。仓库自带 Dockerfile官方还发布 Docker 镜像适合在 CI 里固定版本使用。离线拿二进制后建议校验完整性每个版本目录如 sig/v1.8.2/下都有sha256sum.txt和签名文件用sha256sum -c sha256sum.txt比对哈希即可确认文件未被篡改。收尾下一步行动到这里三个系统的 jq 安装、验证与基础用法已经齐了。建议接下来做三件事用真实的 API 响应或配置文件跑一遍上面的过滤表达式把常用表达式存成带参数的 shell 脚本或别名遇到复杂需求时翻 tests/ 里的现成用例照着改。把这些固化进日常工作流后处理 JSON 就不必再开浏览器或写临时脚本了。【免费下载链接】jqCommand-line JSON processor项目地址: https://gitcode.com/GitHub_Trending/jq/jq创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
