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