# JSON 路径提取器

使用 JSONPath 或 JMESPath 风格表达式查询 JSON，查看匹配路径，并在原始文档中高亮提取结果

> 标准页面: https://elysiatools.com/zh/tools/json-path-extractor

- **分类:** Data Processing

- **关键词:** json, jsonpath, jmespath, 查询, 提取, 高亮

## 概述

JSON 路径提取器是一款专为开发者和数据分析师设计的在线工具，支持使用 JSONPath 或 JMESPath 表达式快速查询和提取 JSON 数据。通过直观的高亮视图或匹配列表，您可以轻松验证查询逻辑、过滤复杂嵌套结构，并精准定位目标字段，大幅提升处理 API 响应或配置文件的效率。

## 输入项

- **JSON 输入** (textarea): { "users": \[ { "name": "Ada", "role": "admin" } \] }
- **查询表达式** (textarea): Use one expression per line. Supports field access, array indexes, wildcards, and simple filters.
- **查询引擎** (select)
- **显示模式** (select)
- **扁平化数组结果** (checkbox)
- **包含空值** (checkbox)
- **最大匹配数** (number)

## 适用场景

- 需要从庞大且嵌套层级深的 API 响应中提取特定字段时。
- 编写和调试 JSONPath 或 JMESPath 表达式，验证匹配结果是否符合预期时。
- 需要快速过滤 JSON 数组中的对象（如按条件筛选用户或订单）并查看原始上下文时。

## 工作原理

- 在输入框中粘贴需要解析的 JSON 文本数据。
- 选择查询引擎（JSONPath 或 JMESPath），并逐行输入您的查询表达式。
- 配置显示模式（高亮 JSON 或匹配列表）以及是否扁平化数组、包含空值等选项。
- 工具将实时解析表达式，并在输出区域高亮显示匹配的节点或列出提取结果。

## 使用案例

- 后端开发者调试 REST API 时，快速验证返回的 JSON 数据中是否包含特定状态码或错误信息。
- 数据分析师从导出的复杂 JSON 日志文件中，批量提取所有高价值订单的商品 SKU 列表。
- 前端工程师在对接接口前，使用表达式过滤出特定权限的用户列表，以便构建本地 Mock 数据。

## 常见问题

### 支持哪些查询语法？

工具目前支持标准的 JSONPath 语法以及 JMESPath 的常用子集，您可以在“查询引擎”选项中进行切换。

### 可以同时输入多个查询表达式吗？

可以，查询表达式输入框支持多行输入，每行代表一个独立的表达式，工具会综合展示所有匹配结果。

### 什么是“高亮 JSON”显示模式？

该模式会在您原始输入的 JSON 结构中，用醒目的背景色标记出被表达式匹配到的键值对或节点，方便您在原始上下文中查看数据。

### 提取结果中的数组可以展开吗？

可以，勾选“扁平化数组结果”选项后，工具会将嵌套的数组结构打平，便于直接查看具体的元素值。

### 匹配数量有上限吗？

有的，为了保证浏览器性能，默认最大匹配数为 30，您可以在设置中最高调整至 200。

## 相关工具

- [结构化日志解析器](https://elysiatools.com/zh/tools/structured-log-analyzer): 自动识别常见日志格式，提取核心字段并推断字段类型，支持导出为 JSON、CSV 或 SQL。
- [Excel 公式计算器](https://elysiatools.com/zh/tools/excel-formula-evaluator): 使用 JSON 单元格值计算受限的 Excel 风格公式，并展示结果、引用与错误诊断。
- [JWK 生成与解析器](https://elysiatools.com/zh/tools/jwk-generator): 生成 RSA、EC（P-256/P-384/P-521/secp256k1）与 OKP（Ed25519/Ed448/X25519/X448）的 JSON Web Key，或解析已有 JWK 以查看参数、指纹与元信息
- [package.json 依赖审计器](https://elysiatools.com/zh/tools/package-json-dependency-auditor): 审计 package.json 的依赖卫生、版本范围质量，并可选地从 package-lock.json 或 yarn.lock 深入检查传递依赖树。会标记重复依赖、通配符或预发布版本、未排序键、缺失元数据，以及运行时/开发时依赖误分类问题。
- [CSV过滤器](https://elysiatools.com/zh/tools/csv-filter): 按列值过滤CSV数据，支持多个条件和运算符。支持12种过滤运算符，包括等于、包含、大于、小于和空值检查。 额外过滤器示例： \[{"column": "年龄", "operator": "greater_than", "value": "25"}\] \[{"column": "状态", "operator": "equals", "value": "激活"}, {"column": "分数", "operator": "greater_equal", "value": "80"}\] \[{"column": "姓名", "operator": "contains", "value": "张"}, {"column": "邮箱", "operator": "is_not_empty"}\]
- [JSON键提取器](https://elysiatools.com/zh/tools/json-key-extractor): 从JSON对象中提取所有键，支持多种输出格式。非常适合分析JSON结构、生成文档和理解复杂的嵌套对象。
- [PDF 表格提取到 CSV/JSON](https://elysiatools.com/zh/tools/pdf-table-extractor-to-csv-json): 用 OpenDataLoader 从 PDF 中抽取表格，并导出为结构化 JSON、扁平 CSV 或 HTML 表格
- [API 响应差异与语义分析器](https://elysiatools.com/zh/tools/api-response-diff-semantic-analyzer): 对比两个 API 响应 JSON，标出字段级差异，并区分真正的功能变更与无害的运行时漂移

## 示例

- [Terraform Plan JSON 样本](https://elysiatools.com/zh/samples/terraform-plan-json-samples): 用于依赖可视化和变更审查的 Terraform plan JSON 文件样本，贴近 terraform show -json 输出结构
- [聊天记录 JSON 示例](https://elysiatools.com/zh/samples/chat-transcript-json): 多角色聊天记录的 JSON 示例
- [JSON 示例](https://elysiatools.com/zh/samples/json): JSON（JavaScript 对象表示法）格式示例，从简单到复杂结构
- [富媒体 JSON 示例](https://elysiatools.com/zh/samples/rich-media-json): 常见富文本编辑器（TipTap、Quill、Slate）的 JSON 示例

## 相关内容

- [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 Schema、Mock 数据与 API 夹具生成工具](https://elysiatools.com/zh/hubs/json-generate): 围绕JSON Schema 生成、Mock 负载构建与 API 夹具准备整理的一组工具。
- [JSON 格式化、对比与规范化工具](https://elysiatools.com/zh/hubs/json-format): 在一个专题中比较 JSON 格式化、差异对比、日志审查、配置比较和数据规范化工具，适合需要让 JSON 更易读、更易审查的流程。