DiagramPreview
基礎解析無需 AI本機預覽除錯友好可匯出

jq 過濾器測試器

貼上 jq 過濾器測試器 內容,在瀏覽器內產生可檢查的本機預覽,適合除錯設定、API 回應、SEO 技術檔與 AI 生成片段。

範例
过滤后的 JSON 结果就緒
預覽結果會顯示在這裡。

下一步可以繼續

把目前預覽結果帶到相關工具,繼續轉換、排查或匯出。

SQL 转 ER 图

把 CREATE TABLE SQL 转成 Mermaid ER 图。

開啟
JSON Schema 可视化

查看 JSON Schema 属性、类型、必填字段和组合结构。

開啟
JSON Schema 表單預覽

把 JSON Schema 的屬性、必填項、列舉和格式轉成表單預覽。

開啟

使用方法

  1. 1第一行写 jq filter,然后用 --- 分隔 JSON payload。
  2. 2先从 .items[] 这类简单选择器开始,再逐步加 map、pipe 或对象构造。
  3. 3复制到脚本或文档前检查过滤结果和行数据。
  4. 4复杂 filter 进入 CI 或生产自动化前,要用真实 jq 验证。

常見場景

API JSON 过滤支持脚本 reviewCI 片段校验AI jq 输出检查文档示例

常見問題

为什么输入要用 ---?

分隔符用于把 jq filter 和要检查的 JSON 文档分开。

这是完整 jq 吗?

不是。它覆盖常见预览场景,高级函数、module、streaming 和生产自动化仍应使用 jq。

如何调试 jq filter?

从能返回数据的最小选择器开始,再一步步添加 pipe 和 mapping。

jq Filter Tester 会用常见 jq 风格过滤器预览 JSON,适合检查 API payload 和生成式 JSON。

它适合支持脚本、CI 检查、文档示例,以及 AI 生成 JSON 转换逻辑的快速验证。

预览会显示过滤结果和结果行;生产行为仍应使用运行环境里的 jq 确认。

Demo:从 JSON 中提取失败检查项

jq filter 最好用同时包含命中和未命中记录的输入来 review,这样能看出条件是否过宽或过窄。

  • 先用 .checks[] 查看 item 结构。
  • 确认字段名后再加 select(.status != "ok")。
  • 需要生成报告时,构造小对象输出。
.checks[] | select(.status != "ok") | {name, status, duration}
---
{
  "checks": [
    {"name": "db", "status": "ok", "duration": 32},
    {"name": "api", "status": "failed", "duration": 914}
  ]
}

调试方法:把 jq 过滤器拆成小步骤

jq 最容易出错的地方是直接写复杂一行。处理日志、API 响应、CI 产物时,应该一段 pipe 一段 pipe 地确认中间结构。

  • 先用 keys、length 或数组选择器确认结构。
  • 确认字段路径存在后再加 select(...) 条件。
  • 用于报告时返回紧凑对象,不要输出整段嵌套记录。
.checks[]
| select(.status == "failed")
| {name, status, duration_ms, owner: .labels.team}

jq 過濾器測試器 檢查清單

當你需要在文件、PR、事故復盤或交接材料發布前檢查原始內容時,可以使用 jq 過濾器測試器。針對 JSON 執行常見 jq 風格過濾器,並預覽過濾結果。

匯出前建議檢查標籤是否可讀、關係是否和原始內容一致、範例是否包含敏感資訊,以及修改輸入後預覽是否仍然成立。

限制與排查

如果預覽失敗,先把輸入縮小到最小完整範例,確認格式語法,再逐段加回內容。

請把預覽結果視為 review 介面,而不是正式事實來源。進入文件或維運流程前仍需要人工確認。

可測試的範例輸入

  • Extract emails: .users[].email --- { "users": [ {"id": 1, "email": "ada@example.com"}, {"id": 2, "email": "lin@example.com"} ] }
  • First order total: .orders[0].total --- {"orders":[{"id":"ord_1","total":49.9},{"id":"ord_2","total":19.5}]}
  • Map field: map(.name) --- [{"name":"api"},{"name":"worker"},{"name":"web"}]

工具完成度

基礎解析

基礎解析

此工具偏向快速結構檢查,適合預覽、排查與定位問題;關鍵輸出進入正式流程前仍需人工複核。

分級不是品質分數,而是說明目前工具更適合穩定匯出、深度除錯、快速解析,或 AI 輔助生成。