# JSONPath 查询工具

用 JSONPath 表达式查询任意 JSON，预览命中结果、切换输出格式，并保存常用查询模板

> 标准页面: https://elysiatools.com/zh/tools/jsonpath-query-tool

- **分类:** Development

- **关键词:** jsonpath, json, query, api, template

## 概述

JSONPath 查询工具是一款专为开发者和数据分析师设计的在线实用工具，支持通过标准的 JSONPath 表达式快速解析和提取复杂的嵌套 JSON 数据。您可以实时预览命中结果，将提取的数据一键转换为 JSON、表格或 Markdown 格式，并支持保存常用查询模板以便后续复用，大幅提升 API 调试和数据处理的效率。

## 输入项

- **JSON 输入** (textarea): { "store": { "book": \[{ "author": "Nigel Rees" }\] } }
- **JSONPath 表达式** (text)
- **输出格式** (select)
- **最大匹配数** (number)
- **保存查询模板** (checkbox)
- **模板名称** (text): Store authors

## 适用场景

- 需要从层级深、结构复杂的 API 响应 JSON 中精准提取特定字段时。
- 在编写代码前，需要快速验证和调试 JSONPath 表达式是否正确时。
- 需要将 JSON 数据中的特定数组或对象转换为 Markdown 或表格格式用于文档编写时。

## 工作原理

- 在输入框中粘贴需要解析的原始 JSON 数据。
- 输入标准的 JSONPath 表达式（如 $.store.book\[*\].author）并设置最大匹配数量。
- 选择期望的输出格式（JSON、Table 或 Markdown），工具将实时高亮并展示提取结果。
- 勾选“保存查询模板”并命名，即可将当前表达式保存为卡片，方便下次直接调用。

## 使用案例

- 后端开发者调试 RESTful API 接口，快速验证返回的 JSON 结构并提取关键业务字段。
- 技术文档工程师从复杂的配置文件中提取特定节点数据，并直接导出为 Markdown 表格插入到说明文档中。
- 自动化测试工程师编写测试用例时，验证 JSONPath 断言表达式的准确性。

## 常见问题

### 支持哪些输出格式？

目前支持将查询结果输出为原始 JSON、数据表格（Table）以及 Markdown 格式，方便直接复制到文档中。

### 最大匹配数有什么作用？

最大匹配数用于限制返回的结果数量（支持 1-500），在处理超大 JSON 数组时可以避免浏览器卡顿并快速预览前 N 条数据。

### 如何保存我的 JSONPath 查询表达式？

勾选“保存查询模板”选项并输入模板名称，执行查询后该表达式将被保存为模板卡片，供后续快捷复用。

### 支持 JSONPath 的过滤查询吗？

支持。您可以使用标准的 JSONPath 过滤语法，例如 $.users[?(@.role == 'admin')] 来筛选符合特定条件的对象。

### 输入的 JSON 数据安全吗？

工具在浏览器前端完成解析和查询，您的 JSON 数据不会被上传到服务器，确保数据隐私和安全。

## 相关工具

- [JSON Schema 转 Zod Schema 转换器](https://elysiatools.com/zh/tools/json-schema-to-zod-schema-converter): 将标准 JSON Schema 的 JSON/YAML 定义转换为可直接在 TypeScript 项目中使用的 Zod 运行时校验代码，支持嵌套结构、数组、枚举和常见校验规则
- [ECharts 主题 Token 抽取器](https://elysiatools.com/zh/tools/echarts-theme-token-extractor): 从 ECharts 主题 JSON 抽取设计 token——颜色、数字、字号与字符串——并直接导出到你的设计系统。粘贴一个主题对象（即通过 echarts.init(dom, themeName) 注册的那种），工具遍历每个叶子节点，为每个颜色（可选地将命名色/rgb 规范化为 hex）、间距数字、字号与字符串打标，然后输出干净的 CSS 变量、Tailwind theme.extend 配置、Style Dictionary tokens.json 或 SCSS 变量。在 ECharts 可视化主题与 Figma/CSS/Tailwind 设计 token 之间架桥，无需逐个手抄。
- [图片调色板转设计令牌](https://elysiatools.com/zh/tools/image-to-design-tokens): 从图片中用 k-means 聚类提取主色，导出为 CSS 变量 / SCSS 变量 / Tailwind 配置 / JSON 设计令牌，并自动为每个颜色生成命名色阶
- [JSON 路径提取器](https://elysiatools.com/zh/tools/json-path-extractor): 使用 JSONPath 或 JMESPath 风格表达式查询 JSON，查看匹配路径，并在原始文档中高亮提取结果
- [JSON 差异可视化](https://elysiatools.com/zh/tools/json-diff-visualizer): 比较两个 JSON 并生成带颜色、路径和统计信息的可视化差异报告
- [JSON键提取器](https://elysiatools.com/zh/tools/json-key-extractor): 从JSON对象中提取所有键，支持多种输出格式。非常适合分析JSON结构、生成文档和理解复杂的嵌套对象。
- [JSON Pointer工具](https://elysiatools.com/zh/tools/json-pointer): 使用JSON Pointer (RFC 6901) 导航和提取JSON中的值
- [JSONPath 交互式测试场](https://elysiatools.com/zh/tools/jsonpath-repl-playground): 一个交互式 JSONPath REPL，可对任意 JSON 运行多步查询管道。每行写一个 JSONPath 表达式（例如先 $..book\[?(@.price<10)\]，再 $\[0:5\]），即可看到每一步的匹配数、路径和值——还附带一个可分享的 URL，编码了你的数据和管道。支持递归下降（$..）、通配符（\[*\]）、过滤器（\[?(@.price<10)\]）、切片（\[0:5:2\]）和负索引。

## 示例

- [JWT 示例](https://elysiatools.com/zh/samples/jwt-samples): 从基础令牌结构到高级安全实现的全面JWT示例
- [Postman Collections - API 测试](https://elysiatools.com/zh/samples/postman-collections): 全面的 Postman collection 示例，包括 API 测试、自动化脚本、环境变量、mock 服务器和 REST API 的高级测试模式
- [Terraform Plan JSON 样本](https://elysiatools.com/zh/samples/terraform-plan-json-samples): 用于依赖可视化和变更审查的 Terraform plan JSON 文件样本，贴近 terraform show -json 输出结构
- [macOS Objective-C 网络编程示例](https://elysiatools.com/zh/samples/macos-networking-objectivec): macOS Objective-C 网络编程示例，包括URLSession、HTTP请求、WebSocket和网络可达性

## 相关内容

- [JSON Schema、Mock 数据与 API 夹具生成工具](https://elysiatools.com/zh/hubs/json-generate): 围绕JSON Schema 生成、Mock 负载构建与 API 夹具准备整理的一组工具。
- [JSON 交换与格式翻译工具](https://elysiatools.com/zh/hubs/json-convert): 在一个专题里比较 JSON 与 CSV、YAML、TOML、GraphQL、XML、Markdown、Excel、BSON、EDN 等结构化格式之间的转换工具。
- [JSON 检查、对比与转换工具](https://elysiatools.com/zh/hubs/json-utility): 把 JSON 格式化、差异对比、路径检查、Schema 校验、合并、转换和导出工具集中到一个专题中，适合 API 与数据处理流程。
- [JSON 格式化、对比与规范化工具](https://elysiatools.com/zh/hubs/json-format): 在一个专题中比较 JSON 格式化、差异对比、日志审查、配置比较和数据规范化工具，适合需要让 JSON 更易读、更易审查的流程。