对比决策指南
jq 与 yq 对比
JSON 优先 jq，YAML 或混合配置格式优先 yq；替换文件前都应预览转换结果。
工具选择只读jqyq
先看决策矩阵
基于官方文档这张表汇总当前注册表和官方来源，不代表两侧已经在同一环境中完成端到端对跑。真正选择前，请用同一个安全样例验证。
| 决策条件 | jq | yq |
|---|---|---|
| 输出合同 | 结构化格式：json, raw text, compact json；标志：-c, -r, -e。 | 结构化格式：yaml, json, xml, csv, properties；标志：-o=json, -o=yaml, -r。 |
| 认证与身份 | 基础操作无需认证。无需服务凭据；仍应把文件系统和网络访问限制在任务范围内。 | 基础操作无需认证。无需服务凭据；仍应把文件系统和网络访问限制在任务范围内。 |
| 可靠性证据 | 证据状态为 verified，文档检查于 2026-07-10；已记录独立测试版本 jq-1.7.1-apple。 | 证据状态为 docs-verified，文档检查于 2026-07-10；尚未记录独立执行版本。 |
| 更适合 | 在本地以确定性输出解析、筛选、校验和转换 JSON。 | 在脚本中读取和转换 YAML、JSON、XML、CSV 与 properties 文件。 |
当前建议
按源格式选择，明确 filter，并把转换和覆盖写分开。
目标、输入与输出
在 Agent 选择命令前，先明确要交付的结果和证据。
jq 与 yq 对比：安全执行步骤
每一步都要在已声明的边界内执行，验证输出后再继续。
审批点与回滚
在列出的决策点停下，并让恢复方法始终紧跟操作。
选 CLI、MCP 还是 API？
根据执行位置、身份、输出合同与权限边界选接口。
建议方案
按源格式选择，明确 filter，并把转换和覆盖写分开。
官方证据与参考
执行前使用这些官方或上游来源确认当前命令行为。