# JSONPath 查询工具

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

> 标准页面: https://test.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://test.elysiatools.com/zh/tools/json-schema-to-zod-schema-converter): 将标准 JSON Schema 的 JSON/YAML 定义转换为可直接在 TypeScript 项目中使用的 Zod 运行时校验代码，支持嵌套结构、数组、枚举和常见校验规则
- [ECharts 主题 Token 抽取器](https://test.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://test.elysiatools.com/zh/tools/image-to-design-tokens): 从图片中用 k-means 聚类提取主色，导出为 CSS 变量 / SCSS 变量 / Tailwind 配置 / JSON 设计令牌，并自动为每个颜色生成命名色阶
- [JSON 路径提取器](https://test.elysiatools.com/zh/tools/json-path-extractor): 使用 JSONPath 或 JMESPath 风格表达式查询 JSON，查看匹配路径，并在原始文档中高亮提取结果
- [LLM 工具调用 JSON Schema 构建器](https://test.elysiatools.com/zh/tools/llm-tool-calling-json-schema-builder): 一次定义 LLM 工具，同时生成 OpenAI、Anthropic、Gemini 三家经过校验的函数调用 payload。
- [MCP Server 契约测试器（stdio + WebSocket 双传输 · JSON Schema 2020-12 工具 schema 校验）](https://test.elysiatools.com/zh/tools/model-context-protocol-mcp-server-tool-schema-stdio-websocket-transport-contract-tester): 对 Model Context Protocol 服务器做端到端契约验证：JSON-RPC 2.0 握手与版本协商、capabilities 交换、tools/list 输入 schema 的 object 根类型与 2020-12 草案编译校验、resources 读写、prompts 获取、ping、未知方法 -32601 语义、sampling/createMessage 往返与 stdio 换行分帧纪律；默认内置参考服务器离线自测，亦可对你的 stdio 命令或 ws:// 端点实测。
- [OCR PDF 转结构化 JSON 桥](https://test.elysiatools.com/zh/tools/ocr-pdf-to-structured-json-bridge): 按几何结构抽取 PDF 文本层（y 坐标分行、列间隙识表、字号识标题、冒号键值对），然后逐字段填入用户提供的 JSON Schema——标签按归一化键名匹配、值按声明类型归一化，并用 ajv 校验。
- [混音包构建器](https://test.elysiatools.com/zh/tools/audio-remix-pack-builder): 把一首音乐变成完整混音包：BPM、调性（含 Camelot）、提示点、四条 Demucs 分轨、MP3 预览和元数据 JSON，全部打包成一个 ZIP。

## 示例

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

## 相关内容

- [HN 评论实体推荐票复核与榜单交付](https://test.elysiatools.com/zh/hubs/hn-entity-recommendation-review-and-ranking-handoff): 把获准使用的 HN 评论导出整理成可追溯推荐榜单：保留语境，区分赞扬、批评和想读意向，复核争议计票，交付经过跨批次核对的结果。
- [JSON 字段提取、转换与数据血缘](https://test.elysiatools.com/zh/hubs/json-extraction-transformation-and-provenance): 按路径提取 JSON 字段，用 JSONata 重塑负载，并记录字段级来源与转换过程；不把血缘记录当作业务语义校验。
