JSONPath 提取

JSONPath Query

输入 JSON
匹配结果
 

使用说明

当 JSON 层级很深、或者只想从一大段数据里取出几个字段时, 用眼睛在缩进里找既慢又容易看错。JSONPath 用一条表达式描述取值路径, 工具会沿着路径走一遍,把命中的值连同它实际所在的路径一起返回。

左侧面板填写表达式,默认是 $ 表示根节点。 支持多结果返回 —— 用通配符或递归下降时可能命中多处, 结果会逐条列出并标注各自的完整路径,便于确认表达式是否精确命中了预期字段。

语法速查

  • $ 根节点
  • .key 取子字段,如 $.data.user.name
  • ['key'] 方括号取值,适合键名含点号或连字符的情况
  • [0] 数组下标,[-1] 取最后一个元素
  • [*] 或 .* 通配,遍历数组元素或对象全部字段
  • ..key 递归下降,在任意深度查找该键名
  • [0:3] 数组切片,取前三个元素

与 JSON Pointer 的区别

JSON Pointer(RFC 6901)是另一种路径表达方式,形如 /data/list/0/name。 它只支持逐级定位,一次只能命中一个值,胜在标准统一、实现简单。 JSONPath 支持通配、递归与切片,可以一次匹配多个结果,表达力更强, 但它没有单一的国际标准,不同实现在边界行为上存在细微差异。 需要跨系统交换路径时用 JSON Pointer,人机交互取值时 JSONPath 更顺手。

调试技巧

不确定结构长什么样时,先用 $ 看根节点,再逐层加一段路径试。 如果某一层返回空,说明该键名不存在 —— 常见原因是大小写不符, 或者该键在数组元素内部而不在当前对象上。 键名含点号(如 user.name 本身就是一个字段名)时, 必须用方括号写法 ['user.name'],点号写法会被拆成两级。

常见问题

支持哪些 JSONPath 语法?
支持根 $、子节点 .key、数组下标 [0]、通配 *、递归下降 ..key、数组切片 [0:3] 与多字段组合。这是日常取值最常用的一层子集。
JSONPath 和 JSON Pointer 有什么区别?
JSON Pointer(RFC 6901)是极简的绝对路径,只支持逐级定位,形如 /data/list/0/name。JSONPath 支持通配、递归和切片,能一次匹配多个结果,表达力更强但非标准统一,不同实现存在细微差异。
匹配不到结果时会怎样?
返回空结果并给出提示,不会抛错中断。可以用通配符先探明结构,再收紧到具体路径。
多个匹配结果怎么展示?
以数组形式返回全部命中项,并标注每项对应的实际路径,便于确认表达式是否精确命中了预期字段。

相关工具

最后更新:2026-11-20